+Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make
+ this function take an index and a GtkToolItem.
+
+ * tests/testtoolbar.c (main): Make "Show Arrow" default to
+ true. Make one of the separators !draw and expand.
+ Update for new highlight_drop_location() API.
+
+ * gtk/gtktoolitem.[ch]: Remove "pack_end" property
+
+ * gtk/gtktoolbar.h: Formatting fixes.
+
+ * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow
+ separator tool items to expand.
+ (logical_to_physical, physical_to_logical): Fix off-by-one errors
+ (Fix #125472, Marco Pesenti Gritti)
+
+ * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property.
+ (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also
+ return FALSE, not TRUE.
+ (gtk_separator_too_item_{set|get}_property,
+ (gtk_separator_tool_item_{set|get}_draw): new functions
+
Fri Oct 24 16:54:04 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.0 ===
+Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make
+ this function take an index and a GtkToolItem.
+
+ * tests/testtoolbar.c (main): Make "Show Arrow" default to
+ true. Make one of the separators !draw and expand.
+ Update for new highlight_drop_location() API.
+
+ * gtk/gtktoolitem.[ch]: Remove "pack_end" property
+
+ * gtk/gtktoolbar.h: Formatting fixes.
+
+ * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow
+ separator tool items to expand.
+ (logical_to_physical, physical_to_logical): Fix off-by-one errors
+ (Fix #125472, Marco Pesenti Gritti)
+
+ * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property.
+ (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also
+ return FALSE, not TRUE.
+ (gtk_separator_too_item_{set|get}_property,
+ (gtk_separator_tool_item_{set|get}_draw): new functions
+
Fri Oct 24 16:54:04 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.0 ===
+Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make
+ this function take an index and a GtkToolItem.
+
+ * tests/testtoolbar.c (main): Make "Show Arrow" default to
+ true. Make one of the separators !draw and expand.
+ Update for new highlight_drop_location() API.
+
+ * gtk/gtktoolitem.[ch]: Remove "pack_end" property
+
+ * gtk/gtktoolbar.h: Formatting fixes.
+
+ * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow
+ separator tool items to expand.
+ (logical_to_physical, physical_to_logical): Fix off-by-one errors
+ (Fix #125472, Marco Pesenti Gritti)
+
+ * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property.
+ (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also
+ return FALSE, not TRUE.
+ (gtk_separator_too_item_{set|get}_property,
+ (gtk_separator_tool_item_{set|get}_draw): new functions
+
Fri Oct 24 16:54:04 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.0 ===
+Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make
+ this function take an index and a GtkToolItem.
+
+ * tests/testtoolbar.c (main): Make "Show Arrow" default to
+ true. Make one of the separators !draw and expand.
+ Update for new highlight_drop_location() API.
+
+ * gtk/gtktoolitem.[ch]: Remove "pack_end" property
+
+ * gtk/gtktoolbar.h: Formatting fixes.
+
+ * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow
+ separator tool items to expand.
+ (logical_to_physical, physical_to_logical): Fix off-by-one errors
+ (Fix #125472, Marco Pesenti Gritti)
+
+ * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property.
+ (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also
+ return FALSE, not TRUE.
+ (gtk_separator_too_item_{set|get}_property,
+ (gtk_separator_tool_item_{set|get}_draw): new functions
+
Fri Oct 24 16:54:04 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.0 ===
+Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make
+ this function take an index and a GtkToolItem.
+
+ * tests/testtoolbar.c (main): Make "Show Arrow" default to
+ true. Make one of the separators !draw and expand.
+ Update for new highlight_drop_location() API.
+
+ * gtk/gtktoolitem.[ch]: Remove "pack_end" property
+
+ * gtk/gtktoolbar.h: Formatting fixes.
+
+ * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow
+ separator tool items to expand.
+ (logical_to_physical, physical_to_logical): Fix off-by-one errors
+ (Fix #125472, Marco Pesenti Gritti)
+
+ * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property.
+ (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also
+ return FALSE, not TRUE.
+ (gtk_separator_too_item_{set|get}_property,
+ (gtk_separator_tool_item_{set|get}_draw): new functions
+
Fri Oct 24 16:54:04 2003 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.0 ===
+Fri Oct 24 13:15:32 2003 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * gtk/tmpl/gtktoolbar.sgml, gtk/tmpl/gtkseparatortoolitem.sgml:
+ Mention the "expand" and "draw" trick for separator tool items.
+
Fri Oct 24 17:21:04 2003 Owen Taylor <otaylor@redhat.com>
* gdk-pixbuf/Makefile.am gtk/Makefile.am: Distribute generated
@object:
@signal_id:
+<!-- ##### SIGNAL GtkAccelGroup::accel-activate ##### -->
+<para>
+
+</para>
+
+@accelgroup: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+@Returns:
+
+<!-- ##### SIGNAL GtkAccelGroup::accel-changed ##### -->
+<para>
+
+</para>
+
+@accelgroup: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
<!-- ##### ARG GtkAccelLabel:accel-object ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-icon-theme-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
+<para>
+
+</para>
+
+
<!-- ##### ARG GtkSettings:gtk-menu-bar-popout-delay ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
+<para>
+
+</para>
+
+
<!-- ##### ARG GtkSettings:gtk-menu-popout-delay ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
+<para>
+
+</para>
+
+
<!-- ##### ARG GtkSettings:gtk-menu-submenu-hysteresis ##### -->
<para>
</para>
+<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT GtkSettingsClass ##### -->
<para>
</para>
+<!-- ##### ARG GtkToolbar:pack-end ##### -->
+<para>
+
+</para>
+
+
<!-- ##### STRUCT GtkTreeSelectionClass ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION gtk_tool_item_get_pack_end ##### -->
+<para>
+
+</para>
+
+@tool_item:
+@Returns:
+
+<!-- ##### FUNCTION gtk_tool_item_set_pack_end ##### -->
+<para>
+
+</para>
+
+@tool_item:
+@pack_end:
+
<!-- ##### FUNCTION gtk_tool_item_toolbar_reconfigured ##### -->
<para>
</para>
-<!-- ##### SIGNAL GtkAccelGroup::accel-activate ##### -->
-<para>
-
-</para>
-
-@accelgroup: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-@Returns:
-
-<!-- ##### SIGNAL GtkAccelGroup::accel-changed ##### -->
-<para>
-
-</para>
-
-@accelgroup: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
<!-- ##### FUNCTION gtk_accel_group_new ##### -->
<para>
</para>
-<!-- ##### ARG GtkAccelLabel:accel-closure ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAccelLabel:accel-widget ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_accel_label_new ##### -->
<para>
Creates a new #GtkAccelLabel.
@Returns: always returns %FALSE.
+<!-- ##### ARG GtkAccelLabel:accel-closure ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAccelLabel:accel-widget ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkAction::activate ##### -->
+<!-- ##### FUNCTION gtk_action_get_name ##### -->
<para>
</para>
-@action: the object which received the signal.
+@action:
+@Returns:
-<!-- ##### SIGNAL GtkAction::connect-proxy ##### -->
+
+<!-- ##### FUNCTION gtk_action_activate ##### -->
<para>
</para>
-@action: the object which received the signal.
-@widget:
+@action:
-<!-- ##### SIGNAL GtkAction::disconnect-proxy ##### -->
+
+<!-- ##### FUNCTION gtk_action_create_icon ##### -->
<para>
</para>
-@action: the object which received the signal.
-@widget:
-
-<!-- ##### ARG GtkAction:hide-if-empty ##### -->
-<para>
+@action:
+@icon_size:
+@Returns:
-</para>
-<!-- ##### ARG GtkAction:is-important ##### -->
+<!-- ##### FUNCTION gtk_action_create_menu_item ##### -->
<para>
</para>
-<!-- ##### ARG GtkAction:label ##### -->
-<para>
+@action:
+@Returns:
-</para>
-<!-- ##### ARG GtkAction:name ##### -->
+<!-- ##### FUNCTION gtk_action_create_tool_item ##### -->
<para>
</para>
-<!-- ##### ARG GtkAction:sensitive ##### -->
-<para>
+@action:
+@Returns:
-</para>
-<!-- ##### ARG GtkAction:short-label ##### -->
+<!-- ##### FUNCTION gtk_action_connect_proxy ##### -->
<para>
</para>
-<!-- ##### ARG GtkAction:stock-id ##### -->
-<para>
+@action:
+@proxy:
-</para>
-<!-- ##### ARG GtkAction:tooltip ##### -->
+<!-- ##### FUNCTION gtk_action_disconnect_proxy ##### -->
<para>
</para>
-<!-- ##### ARG GtkAction:visible ##### -->
-<para>
+@action:
+@proxy:
-</para>
-<!-- ##### FUNCTION gtk_action_get_name ##### -->
+<!-- ##### FUNCTION gtk_action_get_proxies ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_action_activate ##### -->
+<!-- ##### FUNCTION gtk_action_connect_accelerator ##### -->
<para>
</para>
@action:
-<!-- ##### FUNCTION gtk_action_create_icon ##### -->
+<!-- ##### FUNCTION gtk_action_disconnect_accelerator ##### -->
<para>
</para>
@action:
-@icon_size:
-@Returns:
-<!-- ##### FUNCTION gtk_action_create_menu_item ##### -->
+<!-- ##### FUNCTION gtk_action_block_activate_from ##### -->
<para>
</para>
@action:
-@Returns:
+@proxy:
-<!-- ##### FUNCTION gtk_action_create_tool_item ##### -->
+<!-- ##### FUNCTION gtk_action_unblock_activate_from ##### -->
<para>
</para>
@action:
-@Returns:
+@proxy:
-<!-- ##### FUNCTION gtk_action_connect_proxy ##### -->
+<!-- ##### FUNCTION gtk_action_set_accel_path ##### -->
<para>
</para>
@action:
-@proxy:
+@accel_path:
-<!-- ##### FUNCTION gtk_action_disconnect_proxy ##### -->
+<!-- ##### FUNCTION gtk_action_set_accel_group ##### -->
<para>
</para>
@action:
-@proxy:
+@accel_group:
-<!-- ##### FUNCTION gtk_action_get_proxies ##### -->
+<!-- ##### SIGNAL GtkAction::activate ##### -->
<para>
</para>
-@action:
-@Returns:
-
+@action: the object which received the signal.
-<!-- ##### FUNCTION gtk_action_connect_accelerator ##### -->
+<!-- ##### SIGNAL GtkAction::connect-proxy ##### -->
<para>
</para>
-@action:
-
+@action: the object which received the signal.
+@widget:
-<!-- ##### FUNCTION gtk_action_disconnect_accelerator ##### -->
+<!-- ##### SIGNAL GtkAction::disconnect-proxy ##### -->
<para>
</para>
-@action:
+@action: the object which received the signal.
+@widget:
+
+<!-- ##### ARG GtkAction:hide-if-empty ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_action_block_activate_from ##### -->
+<!-- ##### ARG GtkAction:is-important ##### -->
<para>
</para>
-@action:
-@proxy:
+<!-- ##### ARG GtkAction:label ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_action_unblock_activate_from ##### -->
+<!-- ##### ARG GtkAction:name ##### -->
<para>
</para>
-@action:
-@proxy:
+<!-- ##### ARG GtkAction:sensitive ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_action_set_accel_path ##### -->
+<!-- ##### ARG GtkAction:short-label ##### -->
<para>
</para>
-@action:
-@accel_path:
+<!-- ##### ARG GtkAction:stock-id ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_action_set_accel_group ##### -->
+<!-- ##### ARG GtkAction:tooltip ##### -->
<para>
</para>
-@action:
-@accel_group:
+<!-- ##### ARG GtkAction:visible ##### -->
+<para>
+</para>
</para>
-<!-- ##### SIGNAL GtkAdjustment::changed ##### -->
-<para>
-Emitted when one or more of the #GtkAdjustment fields have been changed,
-other than the value field.
-</para>
-
-@adjustment: the object which received the signal.
-
-<!-- ##### SIGNAL GtkAdjustment::value-changed ##### -->
-<para>
-Emitted when the #GtkAdjustment value field has been changed.
-</para>
-
-@adjustment: the object which received the signal.
-
<!-- ##### FUNCTION gtk_adjustment_new ##### -->
<para>
Creates a new #GtkAdjustment.
@adjustment:
+<!-- ##### SIGNAL GtkAdjustment::changed ##### -->
+<para>
+Emitted when one or more of the #GtkAdjustment fields have been changed,
+other than the value field.
+</para>
+
+@adjustment: the object which received the signal.
+
+<!-- ##### SIGNAL GtkAdjustment::value-changed ##### -->
+<para>
+Emitted when the #GtkAdjustment value field has been changed.
+</para>
+
+@adjustment: the object which received the signal.
+
</para>
-<!-- ##### ARG GtkAlignment:bottom-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:left-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:right-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:top-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:xscale ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAlignment:yscale ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_alignment_new ##### -->
<para>
Creates a new #GtkAlignment.
@padding_right:
+<!-- ##### ARG GtkAlignment:bottom-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:left-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:right-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:top-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:xscale ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:yalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAlignment:yscale ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkArrow:arrow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkArrow:shadow-type ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_arrow_new ##### -->
<para>\r
Creates a new arrow widget.\r
@shadow_type: a valid #GtkShadowType.
+<!-- ##### ARG GtkArrow:arrow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkArrow:shadow-type ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkAspectFrame:obey-child ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:ratio ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:yalign ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_aspect_frame_new ##### -->
<para>
Create a new #GtkAspectFrame.
ratio is taken from the requistion of the child.
+<!-- ##### ARG GtkAspectFrame:obey-child ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAspectFrame:ratio ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAspectFrame:xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkAspectFrame:yalign ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkButtonBox:layout-style ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButtonBox:secondary ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
-<para>
-
-</para>
-
<!-- ##### MACRO GTK_BUTTONBOX_DEFAULT ##### -->
<para>
Used internally only.
@is_secondary:
+<!-- ##### ARG GtkButtonBox:layout-style ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButtonBox:secondary ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButtonBox:child-internal-pad-x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButtonBox:child-internal-pad-y ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButtonBox:child-min-height ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButtonBox:child-min-width ##### -->
+<para>
+
+</para>
+
@spacing:
@homogeneous:
-<!-- ##### ARG GtkBox:homogeneous ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:expand ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:fill ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:pack-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkBox:position ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkBoxChild ##### -->
<para>\r
The #GtkBoxChild-struct holds a child widget of GtkBox and describes\r
in #GtkBoxChild-struct.
+<!-- ##### ARG GtkBox:homogeneous ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:expand ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:fill ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:pack-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkBox:position ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkButton::activate ##### -->
-<para>
-
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### SIGNAL GtkButton::clicked ##### -->
-<para>
-Emitted when a button clicked on by the mouse and the cursor stays on the
-button. If the cursor is not on the button when the mouse button is released,
-the signal is not emitted.
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### SIGNAL GtkButton::enter ##### -->
-<para>
-Emitted when the mouse cursor enters the region of the button.
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### SIGNAL GtkButton::leave ##### -->
-<para>
-Emitted when the mouse cursor leaves the region of the button.
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### SIGNAL GtkButton::pressed ##### -->
-<para>
-Emitted when the button is initially pressed.
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### SIGNAL GtkButton::released ##### -->
-<para>
-Emitted when a button which is pressed is released, no matter where the
-mouse cursor is.
-</para>
-
-@button: the object which received the signal.
-
-<!-- ##### ARG GtkButton:focus-on-click ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:relief ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:use-stock ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:use-underline ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:child-displacement-x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:child-displacement-y ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:default-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkButton:default-outside-border ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_button_new ##### -->
<para>
Creates a new #GtkButton widget. To add a child widget to the button,
@Returns:
+<!-- ##### SIGNAL GtkButton::activate ##### -->
+<para>
+
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### SIGNAL GtkButton::clicked ##### -->
+<para>
+Emitted when a button clicked on by the mouse and the cursor stays on the
+button. If the cursor is not on the button when the mouse button is released,
+the signal is not emitted.
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### SIGNAL GtkButton::enter ##### -->
+<para>
+Emitted when the mouse cursor enters the region of the button.
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### SIGNAL GtkButton::leave ##### -->
+<para>
+Emitted when the mouse cursor leaves the region of the button.
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### SIGNAL GtkButton::pressed ##### -->
+<para>
+Emitted when the button is initially pressed.
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### SIGNAL GtkButton::released ##### -->
+<para>
+Emitted when a button which is pressed is released, no matter where the
+mouse cursor is.
+</para>
+
+@button: the object which received the signal.
+
+<!-- ##### ARG GtkButton:focus-on-click ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:relief ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:use-stock ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:use-underline ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:child-displacement-x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:child-displacement-y ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:default-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:default-outside-border ##### -->
+<para>
+
+</para>
+
</note>
-<!-- ##### SIGNAL GtkCalendar::day-selected ##### -->
-<para>
-Emitted when the user selects a day.
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::day-selected-double-click ##### -->
-<para>
-
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::month-changed ##### -->
-<para>
-Emitted when the user clicks a button to change the selected month on a
-calendar.
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::next-month ##### -->
-<para>
-
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::next-year ##### -->
-<para>
-
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::prev-month ##### -->
-<para>
-
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCalendar::prev-year ##### -->
-<para>
-
-</para>
-
-@calendar: the object which received the signal.
-
-<!-- ##### ARG GtkCalendar:day ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:month ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:no-month-change ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:show-day-names ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:show-heading ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:show-week-numbers ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCalendar:year ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkCalendarDisplayOptions ##### -->
<para>
These options can be used to influence the display and behaviour of a #GtkCalendar.
@calendar: a #GtkCalendar.
+<!-- ##### SIGNAL GtkCalendar::day-selected ##### -->
+<para>
+Emitted when the user selects a day.
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::day-selected-double-click ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::month-changed ##### -->
+<para>
+Emitted when the user clicks a button to change the selected month on a
+calendar.
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::next-month ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::next-year ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::prev-month ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCalendar::prev-year ##### -->
+<para>
+
+</para>
+
+@calendar: the object which received the signal.
+
+<!-- ##### ARG GtkCalendar:day ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:month ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:no-month-change ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:show-day-names ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:show-heading ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:show-week-numbers ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCalendar:year ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkCellEditable::editing-done ##### -->
-<para>
-
-</para>
-
-@celleditable: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCellEditable::remove-widget ##### -->
-<para>
-
-</para>
-
-@celleditable: the object which received the signal.
-
<!-- ##### STRUCT GtkCellEditableIface ##### -->
<para>
@cell_editable:
+<!-- ##### SIGNAL GtkCellEditable::editing-done ##### -->
+<para>
+
+</para>
+
+@celleditable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCellEditable::remove-widget ##### -->
+<para>
+
+</para>
+
+@celleditable: the object which received the signal.
+
</para>
-<!-- ##### ARG GtkCellRenderer:cell-background ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:cell-background-gdk ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:cell-background-set ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:height ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:is-expander ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:mode ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:visible ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:xpad ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCellRenderer:ypad ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_cell_renderer_get_size ##### -->
<para>
@height:
+<!-- ##### ARG GtkCellRenderer:cell-background ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:cell-background-gdk ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:cell-background-set ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:height ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:is-expanded ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:is-expander ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:mode ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:visible ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:xpad ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:yalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRenderer:ypad ##### -->
+<para>
+
+</para>
+
</para>
+<!-- ##### FUNCTION gtk_cell_renderer_pixbuf_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
<!-- ##### ARG GtkCellRendererPixbuf:pixbuf ##### -->
<para>
</para>
-<!-- ##### FUNCTION gtk_cell_renderer_pixbuf_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
</para>
+<!-- ##### FUNCTION gtk_cell_renderer_text_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_cell_renderer_text_set_fixed_height_from_font ##### -->
+<para>
+
+</para>
+
+@renderer:
+@number_of_rows:
+
+
<!-- ##### SIGNAL GtkCellRendererText::edited ##### -->
<para>
</para>
-<!-- ##### FUNCTION gtk_cell_renderer_text_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_cell_renderer_text_set_fixed_height_from_font ##### -->
-<para>
-
-</para>
-
-@renderer:
-@number_of_rows:
-
-
</para>
-<!-- ##### SIGNAL GtkCellRendererToggle::toggled ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_toggle_new ##### -->
<para>
</para>
-@cellrenderertoggle: the object which received the signal.
-@arg1:
+@Returns:
-<!-- ##### ARG GtkCellRendererToggle:activatable ##### -->
+
+<!-- ##### FUNCTION gtk_cell_renderer_toggle_get_radio ##### -->
<para>
</para>
-<!-- ##### ARG GtkCellRendererToggle:active ##### -->
-<para>
+@toggle:
+@Returns:
-</para>
-<!-- ##### ARG GtkCellRendererToggle:inconsistent ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_toggle_set_radio ##### -->
<para>
</para>
-<!-- ##### ARG GtkCellRendererToggle:radio ##### -->
-<para>
+@toggle:
+@radio:
-</para>
-<!-- ##### FUNCTION gtk_cell_renderer_toggle_new ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_toggle_get_active ##### -->
<para>
</para>
+@toggle:
@Returns:
-<!-- ##### FUNCTION gtk_cell_renderer_toggle_get_radio ##### -->
+<!-- ##### FUNCTION gtk_cell_renderer_toggle_set_active ##### -->
<para>
</para>
@toggle:
-@Returns:
+@setting:
-<!-- ##### FUNCTION gtk_cell_renderer_toggle_set_radio ##### -->
+<!-- ##### SIGNAL GtkCellRendererToggle::toggled ##### -->
<para>
</para>
-@toggle:
-@radio:
-
+@cellrenderertoggle: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_cell_renderer_toggle_get_active ##### -->
+<!-- ##### ARG GtkCellRendererToggle:activatable ##### -->
<para>
</para>
-@toggle:
-@Returns:
+<!-- ##### ARG GtkCellRendererToggle:active ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_cell_renderer_toggle_set_active ##### -->
+<!-- ##### ARG GtkCellRendererToggle:inconsistent ##### -->
<para>
</para>
-@toggle:
-@setting:
+<!-- ##### ARG GtkCellRendererToggle:radio ##### -->
+<para>
+</para>
</para>
-<!-- ##### ARG GtkCheckButton:indicator-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_check_button_new ##### -->
<para>
Creates a new #GtkCheckButton.
@Returns:
+<!-- ##### ARG GtkCheckButton:indicator-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCheckButton:indicator-spacing ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkCheckMenuItem::toggled ##### -->
-<para>
-This signal is emitted when the state of the check box is changed.
-</para>
-
-<para>
-A signal handler can examine the <structfield>active</structfield>
-field of the #GtkCheckMenuItem-struct struct to discover the new state.
-</para>
-
-@checkmenuitem: the object which received the signal.
-
-<!-- ##### ARG GtkCheckMenuItem:active ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCheckMenuItem:draw-as-radio ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCheckMenuItem:inconsistent ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_check_menu_item_new ##### -->
<para>
Creates a new #GtkCheckMenuItem.
@Returns:
+<!-- ##### SIGNAL GtkCheckMenuItem::toggled ##### -->
+<para>
+This signal is emitted when the state of the check box is changed.
+</para>
+
+<para>
+A signal handler can examine the <structfield>active</structfield>
+field of the #GtkCheckMenuItem-struct struct to discover the new state.
+</para>
+
+@checkmenuitem: the object which received the signal.
+
+<!-- ##### ARG GtkCheckMenuItem:active ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCheckMenuItem:draw-as-radio ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCheckMenuItem:inconsistent ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkCList::abort-column-resize ##### -->
-<para>
-This signal is emitted when a column resize is aborted.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::click-column ##### -->
-<para>
-This signal is emitted when a column title is clicked.
-</para>
-
-@clist: The object which received the signal.
-@column: The number of the column.
-
-<!-- ##### SIGNAL GtkCList::end-selection ##### -->
-<para>
-This signal is emitted when a selection ends in a
-multiple selection CList.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::extend-selection ##### -->
-<para>
-This signal is emitted when the selection is extended.
-</para>
-
-@clist: the object which received the signal.
-@scroll_type: A #GtkScrollType value of any scrolling operation the
-occured during the selection.
-@position: A value between 0.0 and 1.0.
-@auto_start_selection: %TRUE or %FALSE.
-
-<!-- ##### SIGNAL GtkCList::resize-column ##### -->
-<para>
-This signal is emitted when a column is resized.
-</para>
-
-@clist: The object which received the signal.
-@column: The number of the column
-@width: The new width of the column.
-
-<!-- ##### SIGNAL GtkCList::row-move ##### -->
-<para>
-This signal is emitted when a row is moved.
-</para>
-
-@clist: The object which received the signal.
-@arg1: The source position of the row.
-@arg2: The destination position of the row.
-
-<!-- ##### SIGNAL GtkCList::scroll-horizontal ##### -->
-<para>
-This signal is emitted when the CList is scrolled horizontally.
-</para>
-
-@clist: the object which received the signal.
-@scroll_type: A #GtkScrollType value of how the scroll operation occured.
-@position: a value between 0.0 and 1.0.
-
-<!-- ##### SIGNAL GtkCList::scroll-vertical ##### -->
-<para>
-This signal is emitted when the CList is scrolled vertically.
-</para>
-
-@clist: the object which received the signal.
-@scroll_type: A #GtkScrollType value of how the scroll operation occured.
-@position: A value between 0.0 and 1.0.
-
-<!-- ##### SIGNAL GtkCList::select-all ##### -->
-<para>
-This signal is emitted when all the rows are selected in a CList.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::select-row ##### -->
-<para>
-This signal is emitted when the user selects a row in the list.
-It is emitted for every row that is selected in a multi-selection or
-by calling gtk_clist_select_all().
-</para>
-
-@clist: The object which received the signal.
-@row: The row selected.
-@column: The column where the selection occured.
-@event: A #GdkEvent structure for the selection.
-
-<!-- ##### SIGNAL GtkCList::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@clist: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkCList::start-selection ##### -->
-<para>
-This signal is emitted when a drag-selection is started in
-a multiple-selection CList.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::toggle-add-mode ##### -->
-<para>
-This signal is emitted when "add mode" is toggled.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::toggle-focus-row ##### -->
-<para>
-
-</para>
-
-@clist: The object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::undo-selection ##### -->
-<para>
-This signal is emitted when an undo selection occurs in the CList,
-probably via calling gtk_clist_undo_selection().
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::unselect-all ##### -->
-<para>
-This signal is emitted when all rows are unselected in a CList.
-</para>
-
-@clist: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCList::unselect-row ##### -->
-<para>
-This signal is emitted when the user unselects a row in the list.
-It is emitted for every row that is unselected in a multi-selection or
-by calling gtk_clist_unselect_all(). It is also emitted for the
-previously selected row in a "single" or "browse" mode CList.
-</para>
-
-@clist: The object which received the signal.
-@row: The selected row
-@column: The column where the selection occured.
-@event:
-
-<!-- ##### ARG GtkCList:n-columns ##### -->
-<para>
-An integer value for a column.
-</para>
-
-<!-- ##### ARG GtkCList:reorderable ##### -->
-<para>
-A boolean value for determining if the user can re-order the CList's
-columns.
-</para>
-
-<!-- ##### ARG GtkCList:row-height ##### -->
-<para>
-An integer value representing the height of a row in pixels.
-</para>
-
-<!-- ##### ARG GtkCList:selection-mode ##### -->
-<para>
-Sets the type of selection mode for the CList.
-</para>
-
-<!-- ##### ARG GtkCList:shadow-type ##### -->
-<para>
-Sets the shadowing for the CList.
-</para>
-
-<!-- ##### ARG GtkCList:sort-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCList:titles-active ##### -->
-<para>
-A boolean value for setting whether the column titles can be
-clicked.
-</para>
-
-<!-- ##### ARG GtkCList:use-drag-icons ##### -->
-<para>
-A boolean value for setting whether to use icons during drag
-operations.
-</para>
-
<!-- ##### ENUM GtkCellType ##### -->
<para>
Identifies the type of element in the current cell of the CList. Cells can
@adjustment: A pointer to a #GtkAdjustment widget, or NULL.
+<!-- ##### SIGNAL GtkCList::abort-column-resize ##### -->
+<para>
+This signal is emitted when a column resize is aborted.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::click-column ##### -->
+<para>
+This signal is emitted when a column title is clicked.
+</para>
+
+@clist: The object which received the signal.
+@column: The number of the column.
+
+<!-- ##### SIGNAL GtkCList::end-selection ##### -->
+<para>
+This signal is emitted when a selection ends in a
+multiple selection CList.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::extend-selection ##### -->
+<para>
+This signal is emitted when the selection is extended.
+</para>
+
+@clist: the object which received the signal.
+@scroll_type: A #GtkScrollType value of any scrolling operation the
+occured during the selection.
+@position: A value between 0.0 and 1.0.
+@auto_start_selection: %TRUE or %FALSE.
+
+<!-- ##### SIGNAL GtkCList::resize-column ##### -->
+<para>
+This signal is emitted when a column is resized.
+</para>
+
+@clist: The object which received the signal.
+@column: The number of the column
+@width: The new width of the column.
+
+<!-- ##### SIGNAL GtkCList::row-move ##### -->
+<para>
+This signal is emitted when a row is moved.
+</para>
+
+@clist: The object which received the signal.
+@arg1: The source position of the row.
+@arg2: The destination position of the row.
+
+<!-- ##### SIGNAL GtkCList::scroll-horizontal ##### -->
+<para>
+This signal is emitted when the CList is scrolled horizontally.
+</para>
+
+@clist: the object which received the signal.
+@scroll_type: A #GtkScrollType value of how the scroll operation occured.
+@position: a value between 0.0 and 1.0.
+
+<!-- ##### SIGNAL GtkCList::scroll-vertical ##### -->
+<para>
+This signal is emitted when the CList is scrolled vertically.
+</para>
+
+@clist: the object which received the signal.
+@scroll_type: A #GtkScrollType value of how the scroll operation occured.
+@position: A value between 0.0 and 1.0.
+
+<!-- ##### SIGNAL GtkCList::select-all ##### -->
+<para>
+This signal is emitted when all the rows are selected in a CList.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::select-row ##### -->
+<para>
+This signal is emitted when the user selects a row in the list.
+It is emitted for every row that is selected in a multi-selection or
+by calling gtk_clist_select_all().
+</para>
+
+@clist: The object which received the signal.
+@row: The row selected.
+@column: The column where the selection occured.
+@event: A #GdkEvent structure for the selection.
+
+<!-- ##### SIGNAL GtkCList::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@clist: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkCList::start-selection ##### -->
+<para>
+This signal is emitted when a drag-selection is started in
+a multiple-selection CList.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::toggle-add-mode ##### -->
+<para>
+This signal is emitted when "add mode" is toggled.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::toggle-focus-row ##### -->
+<para>
+
+</para>
+
+@clist: The object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::undo-selection ##### -->
+<para>
+This signal is emitted when an undo selection occurs in the CList,
+probably via calling gtk_clist_undo_selection().
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::unselect-all ##### -->
+<para>
+This signal is emitted when all rows are unselected in a CList.
+</para>
+
+@clist: the object which received the signal.
+
+<!-- ##### SIGNAL GtkCList::unselect-row ##### -->
+<para>
+This signal is emitted when the user unselects a row in the list.
+It is emitted for every row that is unselected in a multi-selection or
+by calling gtk_clist_unselect_all(). It is also emitted for the
+previously selected row in a "single" or "browse" mode CList.
+</para>
+
+@clist: The object which received the signal.
+@row: The selected row
+@column: The column where the selection occured.
+@event:
+
+<!-- ##### ARG GtkCList:n-columns ##### -->
+<para>
+An integer value for a column.
+</para>
+
+<!-- ##### ARG GtkCList:reorderable ##### -->
+<para>
+A boolean value for determining if the user can re-order the CList's
+columns.
+</para>
+
+<!-- ##### ARG GtkCList:row-height ##### -->
+<para>
+An integer value representing the height of a row in pixels.
+</para>
+
+<!-- ##### ARG GtkCList:selection-mode ##### -->
+<para>
+Sets the type of selection mode for the CList.
+</para>
+
+<!-- ##### ARG GtkCList:shadow-type ##### -->
+<para>
+Sets the shadowing for the CList.
+</para>
+
+<!-- ##### ARG GtkCList:sort-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCList:titles-active ##### -->
+<para>
+A boolean value for setting whether the column titles can be
+clicked.
+</para>
+
+<!-- ##### ARG GtkCList:use-drag-icons ##### -->
+<para>
+A boolean value for setting whether to use icons during drag
+operations.
+</para>
+
</para>
-<!-- ##### SIGNAL GtkColorButton::color-set ##### -->
-<para>
-
-</para>
-
-@colorbutton: the object which received the signal.
-
-<!-- ##### ARG GtkColorButton:alpha ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorButton:use-alpha ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_color_button_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkColorButton::color-set ##### -->
+<para>
+
+</para>
+
+@colorbutton: the object which received the signal.
+
+<!-- ##### ARG GtkColorButton:alpha ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorButton:color ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorButton:title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorButton:use-alpha ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkColorSelection::color-changed ##### -->
-<para>
-This signal is emitted when the color changes in the #GtkColorSelection
-according to its update policy.
-</para>
-
-@colorselection: the object which received the signal.
-
-<!-- ##### ARG GtkColorSelection:current-alpha ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:current-color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:has-opacity-control ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkColorSelection:has-palette ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_color_selection_new ##### -->
<para>
@color:
+<!-- ##### SIGNAL GtkColorSelection::color-changed ##### -->
+<para>
+This signal is emitted when the color changes in the #GtkColorSelection
+according to its update policy.
+</para>
+
+@colorselection: the object which received the signal.
+
+<!-- ##### ARG GtkColorSelection:current-alpha ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorSelection:current-color ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorSelection:has-opacity-control ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkColorSelection:has-palette ##### -->
+<para>
+
+</para>
+
@entry:
@list:
-<!-- ##### ARG GtkCombo:allow-empty ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCombo:case-sensitive ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCombo:enable-arrow-keys ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCombo:enable-arrows-always ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCombo:value-in-list ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_combo_new ##### -->
<para>
Creates a new #GtkCombo.
@combo: a #GtkCombo.
+<!-- ##### ARG GtkCombo:allow-empty ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCombo:case-sensitive ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCombo:enable-arrow-keys ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCombo:enable-arrows-always ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCombo:value-in-list ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkComboBox::changed ##### -->
-<para>
-
-</para>
-
-@combobox: the object which received the signal.
-
-<!-- ##### ARG GtkComboBox:active ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkComboBox:column-span-column ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkComboBox:model ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkComboBox:row-span-column ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkComboBox:wrap-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkComboBox:appearance ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_combo_box_new ##### -->
<para>
@text:
+<!-- ##### SIGNAL GtkComboBox::changed ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
+<!-- ##### ARG GtkComboBox:active ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkComboBox:column-span-column ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkComboBox:model ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkComboBox:row-span-column ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkComboBox:wrap-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkComboBox:appearance ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkComboBoxEntry:text-column ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_combo_box_entry_new ##### -->
<para>
@Returns:
+<!-- ##### ARG GtkComboBoxEntry:text-column ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkContainer::add ##### -->
-<para>
-
-</para>
-
-@container: the object which received the signal.
-@widget:
-
-<!-- ##### SIGNAL GtkContainer::check-resize ##### -->
-<para>
-
-</para>
-
-@container: the object which received the signal.
-
-<!-- ##### SIGNAL GtkContainer::remove ##### -->
-<para>
-
-</para>
-
-@container: the object which received the signal.
-@widget:
-
-<!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
-<para>
-
-</para>
-
-@container: the object which received the signal.
-@widget:
-
-<!-- ##### ARG GtkContainer:border-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkContainer:child ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkContainer:resize-mode ##### -->
-<para>
-
-</para>
-
<!-- ##### MACRO GTK_IS_RESIZE_CONTAINER ##### -->
<para>
@class:
+<!-- ##### SIGNAL GtkContainer::add ##### -->
+<para>
+
+</para>
+
+@container: the object which received the signal.
+@widget:
+
+<!-- ##### SIGNAL GtkContainer::check-resize ##### -->
+<para>
+
+</para>
+
+@container: the object which received the signal.
+
+<!-- ##### SIGNAL GtkContainer::remove ##### -->
+<para>
+
+</para>
+
+@container: the object which received the signal.
+@widget:
+
+<!-- ##### SIGNAL GtkContainer::set-focus-child ##### -->
+<para>
+
+</para>
+
+@container: the object which received the signal.
+@widget:
+
+<!-- ##### ARG GtkContainer:border-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkContainer:child ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkContainer:resize-mode ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkCTree::change-focus-row-expansion ##### -->
-<para>
-The row which has the focus is either collapsed or expanded
-or toggled.
-</para>
-
-@ctree: the object which received the signal.
-@expansion: What is being done.
-
-<!-- ##### SIGNAL GtkCTree::tree-collapse ##### -->
-<para>
-Emitted when a node is collapsed.
-</para>
-
-@ctree: the object which received the signal.
-@node:
-
-<!-- ##### SIGNAL GtkCTree::tree-expand ##### -->
-<para>
-Emitted when a node is expanded.
-</para>
-
-@ctree: the object which received the signal.
-@node:
-
-<!-- ##### SIGNAL GtkCTree::tree-move ##### -->
-<para>
-Emitted when a node is moved.
-</para>
-
-@ctree: the object which received the signal.
-@node: The node that is moved.
-@new_parent: The new parent of the node.
-@new_sibling: The new sibling of the node.
-
-<!-- ##### SIGNAL GtkCTree::tree-select-row ##### -->
-<para>
-Emitted when a row is selected.
-</para>
-
-@ctree: the object which received the signal.
-@node: The node corresponding to the selected row.
-@column: The column which was selected.
-
-<!-- ##### SIGNAL GtkCTree::tree-unselect-row ##### -->
-<para>
-Emitted when a node is unselected.
-</para>
-
-@ctree: the object which received the signal.
-@node: The node corresponding to the selected row.
-@column:
-
-<!-- ##### ARG GtkCTree:expander-style ##### -->
-<para>
-The style of the expander buttons.
-</para>
-
-<!-- ##### ARG GtkCTree:indent ##### -->
-<para>
-The number of pixels to indent the tree levels.
-</para>
-
-<!-- ##### ARG GtkCTree:line-style ##### -->
-<para>
-The style of the lines in the tree graphic.
-</para>
-
-<!-- ##### ARG GtkCTree:n-columns ##### -->
-<para>
-The number of columns in the tree.
-</para>
-
-<!-- ##### ARG GtkCTree:show-stub ##### -->
-<para>
-FIXME
-</para>
-
-<!-- ##### ARG GtkCTree:spacing ##### -->
-<para>
-The number of pixels between the tree and the columns.
-</para>
-
-<!-- ##### ARG GtkCTree:tree-column ##### -->
-<para>
-The column in which the actual tree graphic appears.
-</para>
-
<!-- ##### MACRO GTK_CTREE_ROW ##### -->
<para>
Used to get the #GtkCTreeRow structure corresponding to the given #GtkCTreeNode.
@show_stub:
+<!-- ##### SIGNAL GtkCTree::change-focus-row-expansion ##### -->
+<para>
+The row which has the focus is either collapsed or expanded
+or toggled.
+</para>
+
+@ctree: the object which received the signal.
+@expansion: What is being done.
+
+<!-- ##### SIGNAL GtkCTree::tree-collapse ##### -->
+<para>
+Emitted when a node is collapsed.
+</para>
+
+@ctree: the object which received the signal.
+@node:
+
+<!-- ##### SIGNAL GtkCTree::tree-expand ##### -->
+<para>
+Emitted when a node is expanded.
+</para>
+
+@ctree: the object which received the signal.
+@node:
+
+<!-- ##### SIGNAL GtkCTree::tree-move ##### -->
+<para>
+Emitted when a node is moved.
+</para>
+
+@ctree: the object which received the signal.
+@node: The node that is moved.
+@new_parent: The new parent of the node.
+@new_sibling: The new sibling of the node.
+
+<!-- ##### SIGNAL GtkCTree::tree-select-row ##### -->
+<para>
+Emitted when a row is selected.
+</para>
+
+@ctree: the object which received the signal.
+@node: The node corresponding to the selected row.
+@column: The column which was selected.
+
+<!-- ##### SIGNAL GtkCTree::tree-unselect-row ##### -->
+<para>
+Emitted when a node is unselected.
+</para>
+
+@ctree: the object which received the signal.
+@node: The node corresponding to the selected row.
+@column:
+
+<!-- ##### ARG GtkCTree:expander-style ##### -->
+<para>
+The style of the expander buttons.
+</para>
+
+<!-- ##### ARG GtkCTree:indent ##### -->
+<para>
+The number of pixels to indent the tree levels.
+</para>
+
+<!-- ##### ARG GtkCTree:line-style ##### -->
+<para>
+The style of the lines in the tree graphic.
+</para>
+
+<!-- ##### ARG GtkCTree:n-columns ##### -->
+<para>
+The number of columns in the tree.
+</para>
+
+<!-- ##### ARG GtkCTree:show-stub ##### -->
+<para>
+FIXME
+</para>
+
+<!-- ##### ARG GtkCTree:spacing ##### -->
+<para>
+The number of pixels between the tree and the columns.
+</para>
+
+<!-- ##### ARG GtkCTree:tree-column ##### -->
+<para>
+The column in which the actual tree graphic appears.
+</para>
+
</para>
-<!-- ##### SIGNAL GtkCurve::curve-type-changed ##### -->
-<para>
-Emitted when the curve type has been changed.
-The curve type can be changed explicitly with a call to
-gtk_curve_set_curve_type(). It is also changed as a side-effect of
-calling gtk_curve_reset() or gtk_curve_set_gamma().
-</para>
-
-@curve: the object which received the signal.
-
-<!-- ##### ARG GtkCurve:curve-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCurve:max-x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCurve:max-y ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCurve:min-x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkCurve:min-y ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_curve_new ##### -->
<para>
Creates a new #GtkCurve.
@type: the type of the curve.
+<!-- ##### SIGNAL GtkCurve::curve-type-changed ##### -->
+<para>
+Emitted when the curve type has been changed.
+The curve type can be changed explicitly with a call to
+gtk_curve_set_curve_type(). It is also changed as a side-effect of
+calling gtk_curve_reset() or gtk_curve_set_gamma().
+</para>
+
+@curve: the object which received the signal.
+
+<!-- ##### ARG GtkCurve:curve-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCurve:max-x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCurve:max-y ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCurve:min-x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCurve:min-y ##### -->
+<para>
+
+</para>
+
@vbox:
@action_area:
-<!-- ##### SIGNAL GtkDialog::close ##### -->
-<para>
-
-</para>
-
-@dialog: the object which received the signal.
-
-<!-- ##### SIGNAL GtkDialog::response ##### -->
-<para>
-Emitted when an action widget is clicked, the dialog receives a delete event, or
-the application programmer calls gtk_dialog_response(). On a delete event, the
-response ID is #GTK_RESPONSE_NONE. Otherwise, it depends on which action widget
-was clicked.
-</para>
-
-@dialog: the object which received the signal.
-@arg1: the response ID
-
-<!-- ##### ARG GtkDialog:has-separator ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkDialog:action-area-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkDialog:button-spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkDialog:content-area-border ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkDialogFlags ##### -->
<para>
@setting:
+<!-- ##### SIGNAL GtkDialog::close ##### -->
+<para>
+
+</para>
+
+@dialog: the object which received the signal.
+
+<!-- ##### SIGNAL GtkDialog::response ##### -->
+<para>
+Emitted when an action widget is clicked, the dialog receives a delete event, or
+the application programmer calls gtk_dialog_response(). On a delete event, the
+response ID is #GTK_RESPONSE_NONE. Otherwise, it depends on which action widget
+was clicked.
+</para>
+
+@dialog: the object which received the signal.
+@arg1: the response ID
+
+<!-- ##### ARG GtkDialog:has-separator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:action-area-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:button-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:content-area-border ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkEditable::changed ##### -->
-<para>
-Indicates that the user has changed the contents
-of the widget.
-</para>
-
-@editable: the object which received the signal.
-
-<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
-<para>
-This signal is emitted when text is deleted from
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely. The @start_pos
-and @end_pos parameters are interpreted as for
-gtk_editable_delete_text()
-</para>
-
-@editable: the object which received the signal.
-@start_pos: the starting position.
-@end_pos: the end position.
-
-<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
-<para>
-This signal is emitted when text is inserted into
-the widget by the user. The default handler for
-this signal will normally be responsible for inserting
-the text, so by connecting to this signal and then
-stopping the signal with gtk_signal_emit_stop(), it
-is possible to modify the inserted text, or prevent
-it from being inserted entirely.
-</para>
-
-@editable: the object which received the signal.
-@new_text: the new text to insert.
-@new_text_length: the length of the new text.
-@position: the position at which to insert the new text.
- this is an in-out paramter. After the signal
- emission is finished, it should point after
- the newly inserted text.
-
<!-- ##### FUNCTION gtk_editable_select_region ##### -->
<para>
Selects a region of text. The characters that
@Returns:
+<!-- ##### SIGNAL GtkEditable::changed ##### -->
+<para>
+Indicates that the user has changed the contents
+of the widget.
+</para>
+
+@editable: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEditable::delete-text ##### -->
+<para>
+This signal is emitted when text is deleted from
+the widget by the user. The default handler for
+this signal will normally be responsible for inserting
+the text, so by connecting to this signal and then
+stopping the signal with gtk_signal_emit_stop(), it
+is possible to modify the inserted text, or prevent
+it from being inserted entirely. The @start_pos
+and @end_pos parameters are interpreted as for
+gtk_editable_delete_text()
+</para>
+
+@editable: the object which received the signal.
+@start_pos: the starting position.
+@end_pos: the end position.
+
+<!-- ##### SIGNAL GtkEditable::insert-text ##### -->
+<para>
+This signal is emitted when text is inserted into
+the widget by the user. The default handler for
+this signal will normally be responsible for inserting
+the text, so by connecting to this signal and then
+stopping the signal with gtk_signal_emit_stop(), it
+is possible to modify the inserted text, or prevent
+it from being inserted entirely.
+</para>
+
+@editable: the object which received the signal.
+@new_text: the new text to insert.
+@new_text_length: the length of the new text.
+@position: the position at which to insert the new text.
+ this is an in-out paramter. After the signal
+ emission is finished, it should point after
+ the newly inserted text.
+
</para>
-<!-- ##### SIGNAL GtkEntry::activate ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-
-<!-- ##### SIGNAL GtkEntry::copy-clipboard ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-
-<!-- ##### SIGNAL GtkEntry::cut-clipboard ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-
-<!-- ##### SIGNAL GtkEntry::delete-from-cursor ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkEntry::insert-at-cursor ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkEntry::move-cursor ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
-<!-- ##### SIGNAL GtkEntry::paste-clipboard ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-
-<!-- ##### SIGNAL GtkEntry::populate-popup ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkEntry::toggle-overwrite ##### -->
-<para>
-
-</para>
-
-@entry: the object which received the signal.
-
-<!-- ##### ARG GtkEntry:activates-default ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:cursor-position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:editable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:has-frame ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:invisible-char ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:max-length ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:scroll-offset ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:selection-bound ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:text ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:visibility ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntry:width-chars ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_entry_new ##### -->
<para>
Creates a new #GtkEntry widget.
@Returns:
+<!-- ##### SIGNAL GtkEntry::activate ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEntry::copy-clipboard ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEntry::cut-clipboard ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEntry::delete-from-cursor ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkEntry::insert-at-cursor ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkEntry::move-cursor ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL GtkEntry::paste-clipboard ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### SIGNAL GtkEntry::populate-popup ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkEntry::toggle-overwrite ##### -->
+<para>
+
+</para>
+
+@entry: the object which received the signal.
+
+<!-- ##### ARG GtkEntry:activates-default ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:cursor-position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:editable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:has-frame ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:invisible-char ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:max-length ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:scroll-offset ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:selection-bound ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:text ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:visibility ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntry:width-chars ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkEntryCompletion::action-activated ##### -->
-<para>
-
-</para>
-
-@entrycompletion: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkEntryCompletion::match-selected ##### -->
-<para>
-
-</para>
-
-@entrycompletion: the object which received the signal.
-@arg1:
-@arg2:
-@Returns:
-
-<!-- ##### ARG GtkEntryCompletion:minimum-key-length ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEntryCompletion:model ##### -->
-<para>
-
-</para>
-
<!-- ##### USER_FUNCTION GtkEntryCompletionMatchFunc ##### -->
<para>
@column:
+<!-- ##### SIGNAL GtkEntryCompletion::action-activated ##### -->
+<para>
+
+</para>
+
+@entrycompletion: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkEntryCompletion::match-selected ##### -->
+<para>
+
+</para>
+
+@entrycompletion: the object which received the signal.
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### ARG GtkEntryCompletion:minimum-key-length ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEntryCompletion:model ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkEventBox:above-child ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkEventBox:visible-window ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_event_box_new ##### -->
<para>
Creates a new #GtkEventBox.
@Returns:
+<!-- ##### ARG GtkEventBox:above-child ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkEventBox:visible-window ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkExpander::activate ##### -->
-<para>
-
-</para>
-
-@expander: the object which received the signal.
-
-<!-- ##### ARG GtkExpander:expanded ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:label-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:use-underline ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:expander-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkExpander:expander-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_expander_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkExpander::activate ##### -->
+<para>
+
+</para>
+
+@expander: the object which received the signal.
+
+<!-- ##### ARG GtkExpander:expanded ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:label-widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:use-underline ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:expander-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkExpander:expander-spacing ##### -->
+<para>
+
+</para>
+
-->
+<!-- ##### SIGNAL GtkFileChooser::current-folder-changed ##### -->
+<para>
+
+</para>
+
+@filechooser: the object which received the signal.
+
+<!-- ##### SIGNAL GtkFileChooser::file-activated ##### -->
+<para>
+
+</para>
+
+@filechooser: the object which received the signal.
+
+<!-- ##### SIGNAL GtkFileChooser::selection-changed ##### -->
+<para>
+
+</para>
+
+@filechooser: the object which received the signal.
+
+<!-- ##### SIGNAL GtkFileChooser::update-preview ##### -->
+<para>
+
+</para>
+
+@filechooser: the object which received the signal.
+
@button_area:
@action_area:
-<!-- ##### ARG GtkFileSelection:filename ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileSelection:select-multiple ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileSelection:show-fileops ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_file_selection_new ##### -->
<para>
Creates a new file selection dialog box. By default it will contain a #GtkTreeView of the application's current working directory, and a file listing. Operation buttons that allow the user to create a directory, delete files and rename files, are also present.
@Returns:
+<!-- ##### ARG GtkFileSelection:filename ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFileSelection:select-multiple ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFileSelection:show-fileops ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkFixed:x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFixed:y ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkFixedChild ##### -->
<para>
The #GtkFixedChild-struct struct contains the following fields.
@has_window:
+<!-- ##### ARG GtkFixed:x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFixed:y ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkFontButton::font-set ##### -->
-<para>
-
-</para>
-
-@fontbutton: the object which received the signal.
-
-<!-- ##### ARG GtkFontButton:font-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontButton:show-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontButton:show-style ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontButton:title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontButton:use-font ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontButton:use-size ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_font_button_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkFontButton::font-set ##### -->
+<para>
+
+</para>
+
+@fontbutton: the object which received the signal.
+
+<!-- ##### ARG GtkFontButton:font-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontButton:show-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontButton:show-style ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontButton:title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontButton:use-font ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontButton:use-size ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkFontSelection:font ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontSelection:font-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFontSelection:preview-text ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_font_selection_new ##### -->
<para>
Creates a new #GtkFontSelection.
@text: the text to display in the preview area.
+<!-- ##### ARG GtkFontSelection:font ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontSelection:font-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFontSelection:preview-text ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkFrame:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:label-yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:shadow ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFrame:shadow-type ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_frame_new ##### -->
<para>
Create a new Frame, with optional label @label.
@Returns:
+<!-- ##### ARG GtkFrame:label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFrame:label-widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFrame:label-xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFrame:label-yalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFrame:shadow ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkFrame:shadow-type ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkHandleBox::child-attached ##### -->
-<para>
-This signal is emitted when the contents of the
-handlebox are reattached to the main window.
-</para>
-
-@handlebox: the object which received the signal.
-@widget: the child widget of the handlebox.
- (this argument provides no extra information
- and is here only for backwards-compatibility)
-
-<!-- ##### SIGNAL GtkHandleBox::child-detached ##### -->
-<para>
-This signal is emitted when the contents of the
-handlebox are detached from the main window.
-</para>
-
-@handlebox: the object which received the signal.
-@widget: the child widget of the handlebox.
- (this argument provides no extra information
- and is here only for backwards-compatibility)
-
-<!-- ##### ARG GtkHandleBox:handle-position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkHandleBox:shadow ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkHandleBox:shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkHandleBox:snap-edge ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkHandleBox:snap-edge-set ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_handle_box_new ##### -->
<para>
Create a new handle box.
@Returns:
+<!-- ##### SIGNAL GtkHandleBox::child-attached ##### -->
+<para>
+This signal is emitted when the contents of the
+handlebox are reattached to the main window.
+</para>
+
+@handlebox: the object which received the signal.
+@widget: the child widget of the handlebox.
+ (this argument provides no extra information
+ and is here only for backwards-compatibility)
+
+<!-- ##### SIGNAL GtkHandleBox::child-detached ##### -->
+<para>
+This signal is emitted when the contents of the
+handlebox are detached from the main window.
+</para>
+
+@handlebox: the object which received the signal.
+@widget: the child widget of the handlebox.
+ (this argument provides no extra information
+ and is here only for backwards-compatibility)
+
+<!-- ##### ARG GtkHandleBox:handle-position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkHandleBox:shadow ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkHandleBox:shadow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkHandleBox:snap-edge ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkHandleBox:snap-edge-set ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkIconTheme::changed ##### -->
-<para>
-
-</para>
-
-@icontheme: the object which received the signal.
-
<!-- ##### ENUM GtkIconLookupFlags ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkIconTheme::changed ##### -->
+<para>
+
+</para>
+
+@icontheme: the object which received the signal.
+
</para>
-<!-- ##### ARG GtkImage:file ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:icon-set ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:icon-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:image ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:mask ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:pixbuf ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:pixbuf-animation ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:pixmap ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:stock ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkImage:storage-type ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkImageType ##### -->
<para>
Describes the image data representation used by a #GtkImage. If you
@mask: a #GdkBitmap that indicates which parts of the image should be transparent.
+<!-- ##### ARG GtkImage:file ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:icon-set ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:icon-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:image ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:mask ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:pixbuf ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:pixbuf-animation ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:pixmap ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:stock ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkImage:storage-type ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkImageMenuItem:image ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_image_menu_item_set_image ##### -->
<para>
@Returns:
+<!-- ##### ARG GtkImageMenuItem:image ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkIMContext::commit ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkIMContext::delete-surrounding ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-@arg1:
-@arg2:
-@Returns:
-
-<!-- ##### SIGNAL GtkIMContext::preedit-changed ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-
-<!-- ##### SIGNAL GtkIMContext::preedit-end ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-
-<!-- ##### SIGNAL GtkIMContext::preedit-start ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-
-<!-- ##### SIGNAL GtkIMContext::retrieve-surrounding ##### -->
-<para>
-
-</para>
-
-@imcontext: the object which received the signal.
-@Returns:
-
<!-- ##### FUNCTION gtk_im_context_set_client_window ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkIMContext::commit ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkIMContext::delete-surrounding ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### SIGNAL GtkIMContext::preedit-changed ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+
+<!-- ##### SIGNAL GtkIMContext::preedit-end ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+
+<!-- ##### SIGNAL GtkIMContext::preedit-start ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+
+<!-- ##### SIGNAL GtkIMContext::retrieve-surrounding ##### -->
+<para>
+
+</para>
+
+@imcontext: the object which received the signal.
+@Returns:
+
</para>
+<!-- ##### FUNCTION gtk_input_dialog_new ##### -->
+<para>
+Creates a new #GtkInputDialog.
+</para>
+
+@Returns: the new #GtkInputDialog.
+
+
<!-- ##### SIGNAL GtkInputDialog::disable-device ##### -->
<para>
This signal is emitted when the user changes the
@inputdialog: the object which received the signal.
@deviceid: The ID of the newly enabled device.
-<!-- ##### FUNCTION gtk_input_dialog_new ##### -->
-<para>
-Creates a new #GtkInputDialog.
-</para>
-
-@Returns: the new #GtkInputDialog.
-
-
</para>
-<!-- ##### ARG GtkInvisible:screen ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_invisible_new ##### -->
<para>
</para>
@Returns:
+<!-- ##### ARG GtkInvisible:screen ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkItem::deselect ##### -->
-<para>
-Emitted when the item is deselected.
-</para>
-
-@item: the object which received the signal.
-
-<!-- ##### SIGNAL GtkItem::select ##### -->
-<para>
-Emitted when the item is selected.
-</para>
-
-@item: the object which received the signal.
-
-<!-- ##### SIGNAL GtkItem::toggle ##### -->
-<para>
-Emitted when the item is toggled.
-</para>
-
-@item: the object which received the signal.
-
<!-- ##### FUNCTION gtk_item_select ##### -->
<para>
Emits the "select" signal on the given item.
@item: a #GtkItem.
+<!-- ##### SIGNAL GtkItem::deselect ##### -->
+<para>
+Emitted when the item is deselected.
+</para>
+
+@item: the object which received the signal.
+
+<!-- ##### SIGNAL GtkItem::select ##### -->
+<para>
+Emitted when the item is selected.
+</para>
+
+@item: the object which received the signal.
+
+<!-- ##### SIGNAL GtkItem::toggle ##### -->
+<para>
+Emitted when the item is toggled.
+</para>
+
+@item: the object which received the signal.
+
</para>
-<!-- ##### SIGNAL GtkLabel::copy-clipboard ##### -->
-<para>
-
-</para>
-
-@label: the object which received the signal.
-
-<!-- ##### SIGNAL GtkLabel::move-cursor ##### -->
-<para>
-
-</para>
-
-@label: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
-<!-- ##### SIGNAL GtkLabel::populate-popup ##### -->
-<para>
-
-</para>
-
-@label: the object which received the signal.
-@arg1:
-
-<!-- ##### ARG GtkLabel:attributes ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:cursor-position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:justify ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:mnemonic-keyval ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:mnemonic-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:pattern ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:selectable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:selection-bound ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:use-markup ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:use-underline ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLabel:wrap ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_label_new ##### -->
<para>
@setting:
+<!-- ##### SIGNAL GtkLabel::copy-clipboard ##### -->
+<para>
+
+</para>
+
+@label: the object which received the signal.
+
+<!-- ##### SIGNAL GtkLabel::move-cursor ##### -->
+<para>
+
+</para>
+
+@label: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL GtkLabel::populate-popup ##### -->
+<para>
+
+</para>
+
+@label: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GtkLabel:attributes ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:cursor-position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:justify ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:mnemonic-keyval ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:mnemonic-widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:pattern ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:selectable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:selection-bound ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:use-markup ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:use-underline ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLabel:wrap ##### -->
+<para>
+
+</para>
+
@bin_window:
-<!-- ##### SIGNAL GtkLayout::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@layout: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### ARG GtkLayout:hadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:height ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:vadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:y ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_layout_new ##### -->
<para>
@adjustment:
+<!-- ##### SIGNAL GtkLayout::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@layout: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GtkLayout:hadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:height ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:vadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:y ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkList::select-child ##### -->
-<para>
-The child @widget has just been selected.
-</para>
-
-@list: the object which received the signal.
-@widget: the newly selected child.
-
-<!-- ##### SIGNAL GtkList::selection-changed ##### -->
-<para>
-The selection of the widget has just changed.
-</para>
-
-@list: the object which received the signal.
-
-<!-- ##### SIGNAL GtkList::unselect-child ##### -->
-<para>
-The child @widget has just been unselected.
-</para>
-
-@list: the object which received the signal.
-@widget: the newly unselected child.
-
-<!-- ##### ARG GtkList:selection-mode ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_list_new ##### -->
<para>
Creates a new #GtkList.
@list: the list widget.
+<!-- ##### SIGNAL GtkList::select-child ##### -->
+<para>
+The child @widget has just been selected.
+</para>
+
+@list: the object which received the signal.
+@widget: the newly selected child.
+
+<!-- ##### SIGNAL GtkList::selection-changed ##### -->
+<para>
+The selection of the widget has just changed.
+</para>
+
+@list: the object which received the signal.
+
+<!-- ##### SIGNAL GtkList::unselect-child ##### -->
+<para>
+The child @widget has just been unselected.
+</para>
+
+@list: the object which received the signal.
+@widget: the newly unselected child.
+
+<!-- ##### ARG GtkList:selection-mode ##### -->
+<para>
+
+</para>
+
</para>
+<!-- ##### FUNCTION gtk_list_item_new ##### -->
+<para>
+Creates a new #GtkListitem.
+</para>
+
+@Returns: a new #GtkListItem.
+
+
+<!-- ##### FUNCTION gtk_list_item_new_with_label ##### -->
+<para>
+Creates a new #GtkListItem with a child label containing the given string.
+</para>
+
+@label: the string to use for the child label.
+@Returns: a new #GtkListItem with a child #GtkLabel with the text set to
+@label.
+
+
+<!-- ##### FUNCTION gtk_list_item_select ##### -->
+<para>
+Selects the item, by emitting the item's "select" signal.
+Depending on the selection mode of the list, this may cause other items to
+be deselected.
+</para>
+
+@list_item: a #GtkListItem.
+
+
+<!-- ##### FUNCTION gtk_list_item_deselect ##### -->
+<para>
+Deselects the item, by emitting the item's "deselect" signal.
+</para>
+
+@list_item: a #GtkListItem.
+
+
<!-- ##### SIGNAL GtkListItem::end-selection ##### -->
<para>
@listitem: the object which received the signal.
-<!-- ##### FUNCTION gtk_list_item_new ##### -->
-<para>
-Creates a new #GtkListitem.
-</para>
-
-@Returns: a new #GtkListItem.
-
-
-<!-- ##### FUNCTION gtk_list_item_new_with_label ##### -->
-<para>
-Creates a new #GtkListItem with a child label containing the given string.
-</para>
-
-@label: the string to use for the child label.
-@Returns: a new #GtkListItem with a child #GtkLabel with the text set to
-@label.
-
-
-<!-- ##### FUNCTION gtk_list_item_select ##### -->
-<para>
-Selects the item, by emitting the item's "select" signal.
-Depending on the selection mode of the list, this may cause other items to
-be deselected.
-</para>
-
-@list_item: a #GtkListItem.
-
-
-<!-- ##### FUNCTION gtk_list_item_deselect ##### -->
-<para>
-Deselects the item, by emitting the item's "deselect" signal.
-</para>
-
-@list_item: a #GtkListItem.
-
-
</para>
-<!-- ##### SIGNAL GtkMenu::move-scroll ##### -->
-<para>
-
-</para>
-
-@menu: the object which received the signal.
-@arg1:
-
-<!-- ##### ARG GtkMenu:tearoff-title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:bottom-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:left-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:right-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:top-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:horizontal-offset ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:vertical-offset ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenu:vertical-padding ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_menu_new ##### -->
<para>
Creates a new #GtkMenu.
@menu: the #GtkMenu being detached.
+<!-- ##### SIGNAL GtkMenu::move-scroll ##### -->
+<para>
+
+</para>
+
+@menu: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GtkMenu:tearoff-title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:bottom-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:left-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:right-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:top-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:horizontal-offset ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:vertical-offset ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenu:vertical-padding ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkMenuBar:internal-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenuBar:shadow-type ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_menu_bar_new ##### -->
<para>
Creates the new #GtkMenuBar
@position: the position in the item list where the @child is added.
+<!-- ##### ARG GtkMenuBar:internal-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenuBar:shadow-type ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkMenuItem::activate ##### -->
-<para>
-Emitted when the item is activated.
-</para>
-
-@menuitem: the object which received the signal.
-
-<!-- ##### SIGNAL GtkMenuItem::activate-item ##### -->
-<para>
-Emitted when the item is activated, but also if the menu item has a
-submenu. For normal applications, the relevant signal is "activate".
-</para>
-
-@menuitem: the object which received the signal.
-
-<!-- ##### SIGNAL GtkMenuItem::toggle-size-allocate ##### -->
-<para>
-
-</para>
-
-@menuitem: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkMenuItem::toggle-size-request ##### -->
-<para>
-
-</para>
-
-@menuitem: the object which received the signal.
-@arg1:
-
-<!-- ##### ARG GtkMenuItem:arrow-spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenuItem:horizontal-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenuItem:selected-shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMenuItem:toggle-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_menu_item_new ##### -->
<para>
Creates a new #GtkMenuItem.
@Returns:
+<!-- ##### SIGNAL GtkMenuItem::activate ##### -->
+<para>
+Emitted when the item is activated.
+</para>
+
+@menuitem: the object which received the signal.
+
+<!-- ##### SIGNAL GtkMenuItem::activate-item ##### -->
+<para>
+Emitted when the item is activated, but also if the menu item has a
+submenu. For normal applications, the relevant signal is "activate".
+</para>
+
+@menuitem: the object which received the signal.
+
+<!-- ##### SIGNAL GtkMenuItem::toggle-size-allocate ##### -->
+<para>
+
+</para>
+
+@menuitem: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkMenuItem::toggle-size-request ##### -->
+<para>
+
+</para>
+
+@menuitem: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GtkMenuItem:arrow-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenuItem:horizontal-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenuItem:selected-shadow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMenuItem:toggle-spacing ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkMenuShell::activate-current ##### -->
-<para>
-An action signal that activates the current menu item within the menu
-shell.
-</para>
-
-@menushell: the object which received the signal.
-@force_hide: if TRUE, hide the menu after activating the menu item.
-
-<!-- ##### SIGNAL GtkMenuShell::cancel ##### -->
-<para>
-An action signal which cancels the selection within the menu shell.
-Causes the GtkMenuShell::selection-done signal to be emitted.
-</para>
-
-@menushell: the object which received the signal.
-
-<!-- ##### SIGNAL GtkMenuShell::cycle-focus ##### -->
-<para>
-
-</para>
-
-@menushell: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkMenuShell::deactivate ##### -->
-<para>
-This signal is emitted when a menu shell is deactivated.
-</para>
-
-@menushell: the object which received the signal.
-
-<!-- ##### SIGNAL GtkMenuShell::move-current ##### -->
-<para>
-An action signal which moves the current menu item in the direction
-specified by @direction.
-</para>
-
-@menushell: the object which received the signal.
-@direction: the direction to move.
-
-<!-- ##### SIGNAL GtkMenuShell::selection-done ##### -->
-<para>
-This signal is emitted when a selection has been completed within a menu
-shell.
-</para>
-
-@menushell: the object which received the signal.
-
<!-- ##### FUNCTION gtk_menu_shell_append ##### -->
<para>
Adds a new #GtkMenuItem to the end of the menu shell's item list.
@GTK_MENU_DIR_NEXT:
@GTK_MENU_DIR_PREV:
+<!-- ##### SIGNAL GtkMenuShell::activate-current ##### -->
+<para>
+An action signal that activates the current menu item within the menu
+shell.
+</para>
+
+@menushell: the object which received the signal.
+@force_hide: if TRUE, hide the menu after activating the menu item.
+
+<!-- ##### SIGNAL GtkMenuShell::cancel ##### -->
+<para>
+An action signal which cancels the selection within the menu shell.
+Causes the GtkMenuShell::selection-done signal to be emitted.
+</para>
+
+@menushell: the object which received the signal.
+
+<!-- ##### SIGNAL GtkMenuShell::cycle-focus ##### -->
+<para>
+
+</para>
+
+@menushell: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkMenuShell::deactivate ##### -->
+<para>
+This signal is emitted when a menu shell is deactivated.
+</para>
+
+@menushell: the object which received the signal.
+
+<!-- ##### SIGNAL GtkMenuShell::move-current ##### -->
+<para>
+An action signal which moves the current menu item in the direction
+specified by @direction.
+</para>
+
+@menushell: the object which received the signal.
+@direction: the direction to move.
+
+<!-- ##### SIGNAL GtkMenuShell::selection-done ##### -->
+<para>
+This signal is emitted when a selection has been completed within a menu
+shell.
+</para>
+
+@menushell: the object which received the signal.
+
</para>
-<!-- ##### ARG GtkMessageDialog:buttons ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMessageDialog:message-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMessageDialog:message-border ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkMessageType ##### -->
<para>
The type of message being displayed in the dialog.
@Returns:
+<!-- ##### ARG GtkMessageDialog:buttons ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMessageDialog:message-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMessageDialog:message-border ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkMisc:xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMisc:xpad ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMisc:yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkMisc:ypad ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_misc_set_alignment ##### -->
<para>
Sets the alignment of the widget.
@ypad:
+<!-- ##### ARG GtkMisc:xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMisc:xpad ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMisc:yalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMisc:ypad ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkNotebook::change-current-page ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1:
-<!-- # Unused Parameters # -->
-@Returns:
-
-<!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkNotebook::move-focus-out ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkNotebook::select-page ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
-<para>
-Emitted when the user or a function changes the current page.
-</para>
-
-@notebook: the object which received the signal.
-@page: the new current page
-@page_num: the index of the page
-
-<!-- ##### ARG GtkNotebook:enable-popup ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:homogeneous ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:page ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:scrollable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:show-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:show-tabs ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-border ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-hborder ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-pos ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-vborder ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:menu-label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-expand ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-fill ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:tab-pack ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:has-backward-stepper ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:has-forward-stepper ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:has-secondary-backward-stepper ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkNotebook:has-secondary-forward-stepper ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkNotebookPage ##### -->
<para>
The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook.
@page_num:
+<!-- ##### SIGNAL GtkNotebook::change-current-page ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1:
+<!-- # Unused Parameters # -->
+@Returns:
+
+<!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkNotebook::move-focus-out ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkNotebook::select-page ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
+<para>
+Emitted when the user or a function changes the current page.
+</para>
+
+@notebook: the object which received the signal.
+@page: the new current page
+@page_num: the index of the page
+
+<!-- ##### ARG GtkNotebook:enable-popup ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:homogeneous ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:page ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:scrollable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:show-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:show-tabs ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-hborder ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-pos ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-vborder ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:menu-label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-expand ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-fill ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:tab-pack ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-backward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-forward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-secondary-backward-stepper ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkNotebook:has-secondary-forward-stepper ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkObject::destroy ##### -->
-<para>
-Signals that all holders of a reference to the #GtkObject should release
-the reference that they hold. May result in finalization of the object
-if all references are released.
-</para>
-
-@object: the object which received the signal.
-
-<!-- ##### ARG GtkObject:user-data ##### -->
-<para>
-
-</para>
-
<!-- ##### MACRO GTK_OBJECT_TYPE ##### -->
<para>
Gets the type of an object.
+<!-- ##### SIGNAL GtkObject::destroy ##### -->
+<para>
+Signals that all holders of a reference to the #GtkObject should release
+the reference that they hold. May result in finalization of the object
+if all references are released.
+</para>
+
+@object: the object which received the signal.
+
+<!-- ##### ARG GtkObject:user-data ##### -->
+<para>
+
+</para>
+
@selection_end_pos:
@has_selection:
+<!-- ##### USER_FUNCTION GtkTextFunction ##### -->
+<para>
+
+</para>
+
+@editable:
+@time_:
+
+
+<!-- ##### FUNCTION gtk_old_editable_claim_selection ##### -->
+<para>
+
+</para>
+
+@old_editable:
+@claim:
+@time_:
+
+
+<!-- ##### FUNCTION gtk_old_editable_changed ##### -->
+<para>
+
+</para>
+
+@old_editable:
+
+
<!-- ##### SIGNAL GtkOldEditable::activate ##### -->
<para>
</para>
-<!-- ##### USER_FUNCTION GtkTextFunction ##### -->
-<para>
-
-</para>
-
-@editable:
-@time_:
-
-
-<!-- ##### FUNCTION gtk_old_editable_claim_selection ##### -->
-<para>
-
-</para>
-
-@old_editable:
-@claim:
-@time_:
-
-
-<!-- ##### FUNCTION gtk_old_editable_changed ##### -->
-<para>
-
-</para>
-
-@old_editable:
-
-
</para>
-<!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
-<para>
-
-</para>
-
-@optionmenu: the object which received the signal.
-
-<!-- ##### ARG GtkOptionMenu:menu ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_option_menu_new ##### -->
<para>
Creates a new #GtkOptionMenu.
@Returns:
+<!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
+<para>
+
+</para>
+
+@optionmenu: the object which received the signal.
+
+<!-- ##### ARG GtkOptionMenu:menu ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkPaned::accept-position ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkPaned::cancel-position ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkPaned::cycle-child-focus ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkPaned::cycle-handle-focus ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkPaned::move-handle ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkPaned::toggle-handle-focus ##### -->
-<para>
-
-</para>
-
-@paned: the object which received the signal.
-@Returns:
-
-<!-- ##### ARG GtkPaned:position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPaned:position-set ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPaned:resize ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPaned:shrink ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkPaned:handle-size ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_paned_add1 ##### -->
<para>
Adds a child to the top or left pane with
@Returns:
+<!-- ##### SIGNAL GtkPaned::accept-position ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkPaned::cancel-position ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkPaned::cycle-child-focus ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkPaned::cycle-handle-focus ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkPaned::move-handle ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkPaned::toggle-handle-focus ##### -->
+<para>
+
+</para>
+
+@paned: the object which received the signal.
+@Returns:
+
+<!-- ##### ARG GtkPaned:position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkPaned:position-set ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkPaned:resize ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkPaned:shrink ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkPaned:handle-size ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkPlug::embedded ##### -->
-<para>
-
-</para>
-
-@plug: the object which received the signal.
-
<!-- ##### FUNCTION gtk_plug_construct ##### -->
<para>
</para>
@Returns:
+<!-- ##### SIGNAL GtkPlug::embedded ##### -->
+<para>
+
+</para>
+
+@plug: the object which received the signal.
+
</para>
-<!-- ##### ARG GtkPreview:expand ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkPreviewInfo ##### -->
<para>
Contains information about global properties
+<!-- ##### ARG GtkPreview:expand ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkProgress:activity-mode ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgress:show-text ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgress:text-xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgress:text-yalign ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_progress_set_show_text ##### -->
<para>
Controls whether progress text is shown.
@max: the maximum progress value.
+<!-- ##### ARG GtkProgress:activity-mode ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgress:show-text ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgress:text-xalign ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgress:text-yalign ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkProgressBar:activity-blocks ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:activity-step ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:adjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:bar-style ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:discrete-blocks ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:fraction ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:orientation ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:pulse-step ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkProgressBar:text ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_progress_bar_new ##### -->
<para>
Creates a new #GtkProgressBar.
@percentage: the new percent complete value.
+<!-- ##### ARG GtkProgressBar:activity-blocks ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:activity-step ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:adjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:bar-style ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:discrete-blocks ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:fraction ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:orientation ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:pulse-step ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkProgressBar:text ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkRadioAction::changed ##### -->
-<para>
-
-</para>
-
-@radioaction: the object which received the signal.
-@arg1:
-
-<!-- ##### ARG GtkRadioAction:value ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_radio_action_get_group ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkRadioAction::changed ##### -->
+<para>
+
+</para>
+
+@radioaction: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GtkRadioAction:value ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkRadioButton:group ##### -->
-<para>
-Sets a new group for a radio button.
-</para>
-
<!-- ##### FUNCTION gtk_radio_button_new ##### -->
<para>
Creates a new #GtkRadioButton. To be of any practical value, a widget should
as @radio_button.
+<!-- ##### ARG GtkRadioButton:group ##### -->
+<para>
+Sets a new group for a radio button.
+</para>
+
</para>
-<!-- ##### SIGNAL GtkRange::adjust-bounds ##### -->
+<!-- ##### FUNCTION gtk_range_get_adjustment ##### -->
<para>
</para>
-@range: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkRange::move-slider ##### -->
-<para>
-Virtual function that moves the slider. Used for keybindings.
-</para>
+@range:
+@Returns:
-@range: the #GtkRange
-@arg1:
-<!-- # Unused Parameters # -->
-@step: how to move the slider
-@arg2:
-<!-- ##### SIGNAL GtkRange::value-changed ##### -->
+<!-- ##### FUNCTION gtk_range_set_update_policy ##### -->
<para>
-Emitted when the range value changes.
-</para>
-@range: the #GtkRange
+</para>
-<!-- ##### ARG GtkRange:adjustment ##### -->
-<para>
+@range:
+@policy:
-</para>
-<!-- ##### ARG GtkRange:inverted ##### -->
+<!-- ##### FUNCTION gtk_range_set_adjustment ##### -->
<para>
</para>
-<!-- ##### ARG GtkRange:update-policy ##### -->
-<para>
+@range:
+@adjustment:
-</para>
-<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
+<!-- ##### FUNCTION gtk_range_get_inverted ##### -->
<para>
</para>
-<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
-<para>
+@range:
+@Returns:
-</para>
-<!-- ##### ARG GtkRange:slider-width ##### -->
+<!-- ##### FUNCTION gtk_range_set_inverted ##### -->
<para>
</para>
-<!-- ##### ARG GtkRange:stepper-size ##### -->
-<para>
+@range:
+@setting:
-</para>
-<!-- ##### ARG GtkRange:stepper-spacing ##### -->
+<!-- ##### FUNCTION gtk_range_get_update_policy ##### -->
<para>
</para>
-<!-- ##### ARG GtkRange:trough-border ##### -->
-<para>
+@range:
+@Returns:
-</para>
-<!-- ##### FUNCTION gtk_range_get_adjustment ##### -->
+<!-- ##### FUNCTION gtk_range_get_value ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_range_set_update_policy ##### -->
+<!-- ##### FUNCTION gtk_range_set_increments ##### -->
<para>
</para>
@range:
-@policy:
+@step:
+@page:
-<!-- ##### FUNCTION gtk_range_set_adjustment ##### -->
+<!-- ##### FUNCTION gtk_range_set_range ##### -->
<para>
</para>
@range:
-@adjustment:
+@min:
+@max:
-<!-- ##### FUNCTION gtk_range_get_inverted ##### -->
+<!-- ##### FUNCTION gtk_range_set_value ##### -->
<para>
</para>
@range:
-@Returns:
+@value:
-<!-- ##### FUNCTION gtk_range_set_inverted ##### -->
+<!-- ##### SIGNAL GtkRange::adjust-bounds ##### -->
<para>
</para>
-@range:
-@setting:
-
+@range: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_range_get_update_policy ##### -->
+<!-- ##### SIGNAL GtkRange::move-slider ##### -->
<para>
+Virtual function that moves the slider. Used for keybindings.
+</para>
+
+@range: the #GtkRange
+@arg1:
+<!-- # Unused Parameters # -->
+@step: how to move the slider
+@arg2:
+<!-- ##### SIGNAL GtkRange::value-changed ##### -->
+<para>
+Emitted when the range value changes.
</para>
-@range:
-@Returns:
+@range: the #GtkRange
+
+<!-- ##### ARG GtkRange:adjustment ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_range_get_value ##### -->
+<!-- ##### ARG GtkRange:inverted ##### -->
<para>
</para>
-@range:
-@Returns:
+<!-- ##### ARG GtkRange:update-policy ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_range_set_increments ##### -->
+<!-- ##### ARG GtkRange:arrow-displacement-x ##### -->
<para>
</para>
-@range:
-@step:
-@page:
+<!-- ##### ARG GtkRange:arrow-displacement-y ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_range_set_range ##### -->
+<!-- ##### ARG GtkRange:slider-width ##### -->
<para>
</para>
-@range:
-@min:
-@max:
+<!-- ##### ARG GtkRange:stepper-size ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_range_set_value ##### -->
+<!-- ##### ARG GtkRange:stepper-spacing ##### -->
<para>
</para>
-@range:
-@value:
+<!-- ##### ARG GtkRange:trough-border ##### -->
+<para>
+</para>
</para>
-<!-- ##### ARG GtkRuler:lower ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkRuler:max-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkRuler:position ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkRuler:upper ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkRulerMetric ##### -->
<para>
This should be points_per_unit. This is the size of the unit in 1/72nd's of an inch and has nothing to do with screen pixels.
@max_size:
+<!-- ##### ARG GtkRuler:lower ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRuler:max-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRuler:position ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRuler:upper ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkScale::format-value ##### -->
-<para>
-Signal which allows you to change how the scale value is displayed. Connect a
-signal handler which returns an allocated string representing @value.
-That string will then be used to display the scale's value.
-Here's an example signal handler which displays a value 1.0 as
-with "-->1.0<--".
-<informalexample><programlisting>
-static gchar*
-format_value_callback (GtkScale *scale,
- gdouble value)
-{
- return g_strdup_printf ("-->%0.*g<--",
- gtk_scale_get_digits (scale), value);
-}
-</programlisting></informalexample>
-</para>
-
-@scale: the object which received the signal.
-@arg1:
-@Returns: allocated string representing @value
-<!-- # Unused Parameters # -->
-@value: value to format
-
-<!-- ##### ARG GtkScale:digits ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScale:draw-value ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScale:value-pos ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScale:slider-length ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScale:value-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_scale_set_digits ##### -->
<para>
Sets the number of decimal places that are displayed in the value. Also causes
@Returns: the position in which the current value is displayed.
+<!-- ##### SIGNAL GtkScale::format-value ##### -->
+<para>
+Signal which allows you to change how the scale value is displayed. Connect a
+signal handler which returns an allocated string representing @value.
+That string will then be used to display the scale's value.
+Here's an example signal handler which displays a value 1.0 as
+with "-->1.0<--".
+<informalexample><programlisting>
+static gchar*
+format_value_callback (GtkScale *scale,
+ gdouble value)
+{
+ return g_strdup_printf ("-->%0.*g<--",
+ gtk_scale_get_digits (scale), value);
+}
+</programlisting></informalexample>
+</para>
+
+@scale: the object which received the signal.
+@arg1:
+@Returns: allocated string representing @value
+<!-- # Unused Parameters # -->
+@value: value to format
+
+<!-- ##### ARG GtkScale:digits ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScale:draw-value ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScale:value-pos ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScale:slider-length ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScale:value-spacing ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkScrolledWindow::move-focus-out ##### -->
-<para>
-
-</para>
-
-@scrolledwindow: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkScrolledWindow::scroll-child ##### -->
-<para>
-
-</para>
-
-@scrolledwindow: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### ARG GtkScrolledWindow:hadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:hscrollbar-policy ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:vadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:vscrollbar-policy ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:window-placement ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkScrolledWindow:scrollbar-spacing ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_scrolled_window_new ##### -->
<para>
Creates a new scrolled window. The two arguments are the scrolled
@Returns:
+<!-- ##### SIGNAL GtkScrolledWindow::move-focus-out ##### -->
+<para>
+
+</para>
+
+@scrolledwindow: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkScrolledWindow::scroll-child ##### -->
+<para>
+
+</para>
+
+@scrolledwindow: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GtkScrolledWindow:hadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:hscrollbar-policy ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:shadow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:vadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:vscrollbar-policy ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:window-placement ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkScrolledWindow:scrollbar-spacing ##### -->
+<para>
+
+</para>
+
#GtkToolItems. Depending on the theme, a #GtkSeparatorToolItem will
often look like a vertical line on horizontally docked toolbars.
</para>
+<para>
+If the property "expand" is #TRUE and the property "draw" is #FALSE, a
+#GtkSeparatorToolItem will act as a "spring" that forces other items
+to the ends of the toolbar.
+</para>
<para>
Use gtk_separator_tool_item_new() to create a new #GtkSeparatorToolItem.
</para>
@Returns:
+<!-- ##### ARG GtkSeparatorToolItem:draw ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-icon-theme-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkSettingsValue ##### -->
<para>
</para>
-<!-- ##### ARG GtkSizeGroup:mode ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkSizeGroupMode ##### -->
<para>
@widget:
+<!-- ##### ARG GtkSizeGroup:mode ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkSocket::plug-added ##### -->
-<para>
-This signal is emitted when a client is successfully
-added to the socket.
-</para>
-
-@socket: the object which received the signal.
-<!-- # Unused Parameters # -->
-@socket_: the object which received the signal.
-
-<!-- ##### SIGNAL GtkSocket::plug-removed ##### -->
-<para>
-This signal is emitted when a client is removed from the socket. The
-default action is to destroy the #GtkSocket widget, so if you want to
-reuse it you must add a signal handler that returns %TRUE.
-</para>
-
-@socket: the object which received the signal.
-@Returns:
-<!-- # Unused Parameters # -->
-@socket_: the object which received the signal.
-
<!-- ##### FUNCTION gtk_socket_new ##### -->
<para>
</para>
@Returns:
+<!-- ##### SIGNAL GtkSocket::plug-added ##### -->
+<para>
+This signal is emitted when a client is successfully
+added to the socket.
+</para>
+
+@socket: the object which received the signal.
+<!-- # Unused Parameters # -->
+@socket_: the object which received the signal.
+
+<!-- ##### SIGNAL GtkSocket::plug-removed ##### -->
+<para>
+This signal is emitted when a client is removed from the socket. The
+default action is to destroy the #GtkSocket widget, so if you want to
+reuse it you must add a signal handler that returns %TRUE.
+</para>
+
+@socket: the object which received the signal.
+@Returns:
+<!-- # Unused Parameters # -->
+@socket_: the object which received the signal.
+
</para>
-<!-- ##### SIGNAL GtkSpinButton::change-value ##### -->
-<para>
-
-</para>
-
-@spinbutton: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkSpinButton::input ##### -->
-<para>
-
-</para>
-
-@spinbutton: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkSpinButton::output ##### -->
-<para>
-
-</para>
-
-@spinbutton: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkSpinButton::value-changed ##### -->
-<para>
-
-</para>
-
-@spinbutton: the object which received the signal.
-
-<!-- ##### ARG GtkSpinButton:adjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:climb-rate ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:digits ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:numeric ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:snap-to-ticks ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:update-policy ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:value ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:wrap ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSpinButton:shadow-type ##### -->
-<para>
-the type of border that surrounds the arrows of a spin button.
-</para>
-
<!-- ##### ENUM GtkSpinButtonUpdatePolicy ##### -->
<para>
+<!-- ##### SIGNAL GtkSpinButton::change-value ##### -->
+<para>
+
+</para>
+
+@spinbutton: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkSpinButton::input ##### -->
+<para>
+
+</para>
+
+@spinbutton: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkSpinButton::output ##### -->
+<para>
+
+</para>
+
+@spinbutton: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkSpinButton::value-changed ##### -->
+<para>
+
+</para>
+
+@spinbutton: the object which received the signal.
+
+<!-- ##### ARG GtkSpinButton:adjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:climb-rate ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:digits ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:numeric ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:snap-to-ticks ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:update-policy ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:value ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:wrap ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkSpinButton:shadow-type ##### -->
+<para>
+the type of border that surrounds the arrows of a spin button.
+</para>
+
</para>
-<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
-<para>
-Is emitted whenever a new message is popped off a statusbar's stack.
-</para>
-
-@statusbar: the object which received the signal.
-@context_id: the context id of the relevant message/statusbar.
-@text: the message that was just popped.
-
-<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
-<para>
-Is emitted whenever a new message gets pushed onto a statusbar's stack.
-</para>
-
-@statusbar: the object which received the signal.
-@context_id: the context id of the relevant message/statusbar.
-@text: the message that was pushed.
-
-<!-- ##### ARG GtkStatusbar:has-resize-grip ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_statusbar_new ##### -->
<para>
Creates a new #GtkStatusbar ready for messages.
@Returns: %TRUE if the statusbar has a resize grip.
+<!-- ##### SIGNAL GtkStatusbar::text-popped ##### -->
+<para>
+Is emitted whenever a new message is popped off a statusbar's stack.
+</para>
+
+@statusbar: the object which received the signal.
+@context_id: the context id of the relevant message/statusbar.
+@text: the message that was just popped.
+
+<!-- ##### SIGNAL GtkStatusbar::text-pushed ##### -->
+<para>
+Is emitted whenever a new message gets pushed onto a statusbar's stack.
+</para>
+
+@statusbar: the object which received the signal.
+@context_id: the context id of the relevant message/statusbar.
+@text: the message that was pushed.
+
+<!-- ##### ARG GtkStatusbar:has-resize-grip ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkStatusbar:shadow-type ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkTable:column-spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:homogeneous ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:n-columns ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:n-rows ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:row-spacing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:bottom-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:left-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:right-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:top-attach ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:x-options ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:x-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:y-options ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTable:y-padding ##### -->
-<para>
-
-</para>
-
<!-- ##### STRUCT GtkTableChild ##### -->
<para>
The <structfield>widget</structfield> field is a pointer to the widget that
@Returns:
+<!-- ##### ARG GtkTable:column-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:homogeneous ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:n-columns ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:n-rows ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:row-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:bottom-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:left-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:right-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:top-attach ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:x-options ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:x-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:y-options ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTable:y-padding ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkText::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@text: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### ARG GtkText:hadjustment ##### -->
-<para>
-Used by the #GtkText widget to keep track of the size of its horizontal
-text.
-</para>
-
-<!-- ##### ARG GtkText:line-wrap ##### -->
-<para>
-Boolean value indicating whether line wrap is enabled or not.
-</para>
-
-<!-- ##### ARG GtkText:vadjustment ##### -->
-<para>
-Used by the #GtkText widget to keep track of the size of its vertical
-text.
-</para>
-
-<!-- ##### ARG GtkText:word-wrap ##### -->
-<para>
-Boolean value indicated whether word wrap is enabled or not.
-</para>
-
<!-- ##### STRUCT GtkTextFont ##### -->
<para>
Internal #GtkText data type.
@index: the number of characters from the upper left corner
+<!-- ##### SIGNAL GtkText::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@text: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GtkText:hadjustment ##### -->
+<para>
+Used by the #GtkText widget to keep track of the size of its horizontal
+text.
+</para>
+
+<!-- ##### ARG GtkText:line-wrap ##### -->
+<para>
+Boolean value indicating whether line wrap is enabled or not.
+</para>
+
+<!-- ##### ARG GtkText:vadjustment ##### -->
+<para>
+Used by the #GtkText widget to keep track of the size of its vertical
+text.
+</para>
+
+<!-- ##### ARG GtkText:word-wrap ##### -->
+<para>
+Boolean value indicated whether word wrap is enabled or not.
+</para>
+
</para>
-<!-- ##### SIGNAL GtkTextBuffer::apply-tag ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
-<!-- ##### SIGNAL GtkTextBuffer::begin-user-action ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextBuffer::changed ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextBuffer::delete-range ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextBuffer::end-user-action ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextBuffer::insert-child-anchor ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextBuffer::insert-pixbuf ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextBuffer::insert-text ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-<!-- # Unused Parameters # -->
-@arg4:
-
-<!-- ##### SIGNAL GtkTextBuffer::mark-deleted ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextBuffer::mark-set ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextBuffer::modified-changed ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextBuffer::remove-tag ##### -->
-<para>
-
-</para>
-
-@textbuffer: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
-<!-- ##### ARG GtkTextBuffer:tag-table ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_text_buffer_new ##### -->
<para>
@clipboard:
+<!-- ##### SIGNAL GtkTextBuffer::apply-tag ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL GtkTextBuffer::begin-user-action ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextBuffer::changed ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextBuffer::delete-range ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextBuffer::end-user-action ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextBuffer::insert-child-anchor ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextBuffer::insert-pixbuf ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextBuffer::insert-text ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+<!-- # Unused Parameters # -->
+@arg4:
+
+<!-- ##### SIGNAL GtkTextBuffer::mark-deleted ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextBuffer::mark-set ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextBuffer::modified-changed ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextBuffer::remove-tag ##### -->
+<para>
+
+</para>
+
+@textbuffer: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### ARG GtkTextBuffer:tag-table ##### -->
+<para>
+
+</para>
+
</para>
+<!-- ##### ENUM GtkWrapMode ##### -->
+<para>
+Describes a type of line wrapping.
+</para>
+
+@GTK_WRAP_NONE: do not wrap lines; just make the text area wider
+@GTK_WRAP_CHAR: wrap text, breaking lines anywhere the cursor can
+ appear (between characters, usually - if you want to
+ be technical, between graphemes, see
+ pango_get_log_attrs())
+@GTK_WRAP_WORD: wrap text, breaking lines in between words
+@GTK_WRAP_WORD_CHAR: wrap text, breaking lines in between words, or if
+ that is not enough, also between graphemes.
+
+<!-- ##### STRUCT GtkTextAttributes ##### -->
+<para>
+Using #GtkTextAttributes directly should rarely be necessary. It's
+primarily useful with gtk_text_iter_get_attributes(). As with most
+GTK+ structs, the fields in this struct should only be read, never
+modified directly.
+</para>
+
+@appearance: pointer to sub-struct containing certain attributes
+@justification:
+@direction:
+@font:
+@font_scale:
+@left_margin:
+@indent:
+@right_margin:
+@pixels_above_lines:
+@pixels_below_lines:
+@pixels_inside_wrap:
+@tabs:
+@wrap_mode:
+@language:
+@invisible:
+@bg_full_height:
+@editable:
+@realized:
+
+<!-- ##### FUNCTION gtk_text_tag_new ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_text_tag_get_priority ##### -->
+<para>
+
+</para>
+
+@tag:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_text_tag_set_priority ##### -->
+<para>
+
+</para>
+
+@tag:
+@priority:
+
+
+<!-- ##### FUNCTION gtk_text_tag_event ##### -->
+<para>
+
+</para>
+
+@tag:
+@event_object:
+@event:
+@iter:
+@Returns:
+
+
+<!-- ##### STRUCT GtkTextAppearance ##### -->
+<para>
+
+</para>
+
+@bg_color:
+@fg_color:
+@bg_stipple:
+@fg_stipple:
+@rise:
+@underline:
+@strikethrough:
+@draw_bg:
+@inside_selection:
+@is_text:
+
+<!-- ##### FUNCTION gtk_text_attributes_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_text_attributes_copy ##### -->
+<para>
+
+</para>
+
+@src:
+@Returns:
+<!-- # Unused Parameters # -->
+@dest:
+
+
+<!-- ##### FUNCTION gtk_text_attributes_copy_values ##### -->
+<para>
+
+</para>
+
+@src:
+@dest:
+
+
+<!-- ##### FUNCTION gtk_text_attributes_unref ##### -->
+<para>
+
+</para>
+
+@values:
+
+
+<!-- ##### FUNCTION gtk_text_attributes_ref ##### -->
+<para>
+
+</para>
+
+@values:
+
+
<!-- ##### SIGNAL GtkTextTag::event ##### -->
<para>
</para>
-<!-- ##### ENUM GtkWrapMode ##### -->
-<para>
-Describes a type of line wrapping.
-</para>
-
-@GTK_WRAP_NONE: do not wrap lines; just make the text area wider
-@GTK_WRAP_CHAR: wrap text, breaking lines anywhere the cursor can
- appear (between characters, usually - if you want to
- be technical, between graphemes, see
- pango_get_log_attrs())
-@GTK_WRAP_WORD: wrap text, breaking lines in between words
-@GTK_WRAP_WORD_CHAR: wrap text, breaking lines in between words, or if
- that is not enough, also between graphemes.
-
-<!-- ##### STRUCT GtkTextAttributes ##### -->
-<para>
-Using #GtkTextAttributes directly should rarely be necessary. It's
-primarily useful with gtk_text_iter_get_attributes(). As with most
-GTK+ structs, the fields in this struct should only be read, never
-modified directly.
-</para>
-
-@appearance: pointer to sub-struct containing certain attributes
-@justification:
-@direction:
-@font:
-@font_scale:
-@left_margin:
-@indent:
-@right_margin:
-@pixels_above_lines:
-@pixels_below_lines:
-@pixels_inside_wrap:
-@tabs:
-@wrap_mode:
-@language:
-@invisible:
-@bg_full_height:
-@editable:
-@realized:
-
-<!-- ##### FUNCTION gtk_text_tag_new ##### -->
-<para>
-
-</para>
-
-@name:
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_text_tag_get_priority ##### -->
-<para>
-
-</para>
-
-@tag:
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_text_tag_set_priority ##### -->
-<para>
-
-</para>
-
-@tag:
-@priority:
-
-
-<!-- ##### FUNCTION gtk_text_tag_event ##### -->
-<para>
-
-</para>
-
-@tag:
-@event_object:
-@event:
-@iter:
-@Returns:
-
-
-<!-- ##### STRUCT GtkTextAppearance ##### -->
-<para>
-
-</para>
-
-@bg_color:
-@fg_color:
-@bg_stipple:
-@fg_stipple:
-@rise:
-@underline:
-@strikethrough:
-@draw_bg:
-@inside_selection:
-@is_text:
-
-<!-- ##### FUNCTION gtk_text_attributes_new ##### -->
-<para>
-
-</para>
-
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_text_attributes_copy ##### -->
-<para>
-
-</para>
-
-@src:
-@Returns:
-<!-- # Unused Parameters # -->
-@dest:
-
-
-<!-- ##### FUNCTION gtk_text_attributes_copy_values ##### -->
-<para>
-
-</para>
-
-@src:
-@dest:
-
-
-<!-- ##### FUNCTION gtk_text_attributes_unref ##### -->
-<para>
-
-</para>
-
-@values:
-
-
-<!-- ##### FUNCTION gtk_text_attributes_ref ##### -->
-<para>
-
-</para>
-
-@values:
-
-
</para>
-<!-- ##### SIGNAL GtkTextTagTable::tag-added ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextTagTable::tag-changed ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextTagTable::tag-removed ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1:
-
<!-- ##### USER_FUNCTION GtkTextTagTableForeach ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkTextTagTable::tag-added ##### -->
+<para>
+
+</para>
+
+@texttagtable: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextTagTable::tag-changed ##### -->
+<para>
+
+</para>
+
+@texttagtable: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextTagTable::tag-removed ##### -->
+<para>
+
+</para>
+
+@texttagtable: the object which received the signal.
+@arg1:
+
</para>
-<!-- ##### SIGNAL GtkTextView::copy-clipboard ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextView::cut-clipboard ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextView::delete-from-cursor ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextView::insert-at-cursor ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextView::move-cursor ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
-<!-- ##### SIGNAL GtkTextView::move-focus ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextView::move-viewport ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextView::page-horizontally ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextView::paste-clipboard ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextView::populate-popup ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextView::select-all ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTextView::set-anchor ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTextView::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTextView::toggle-overwrite ##### -->
-<para>
-
-</para>
-
-@textview: the object which received the signal.
-
-<!-- ##### ARG GtkTextView:accepts-tab ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:buffer ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:cursor-visible ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:editable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:indent ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:justification ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:left-margin ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:overwrite ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:pixels-above-lines ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:pixels-below-lines ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:pixels-inside-wrap ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:right-margin ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:tabs ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTextView:wrap-mode ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkTextWindowType ##### -->
<para>
+<!-- ##### SIGNAL GtkTextView::copy-clipboard ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextView::cut-clipboard ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextView::delete-from-cursor ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextView::insert-at-cursor ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextView::move-cursor ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL GtkTextView::move-focus ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextView::move-viewport ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextView::page-horizontally ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextView::paste-clipboard ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextView::populate-popup ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextView::select-all ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTextView::set-anchor ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTextView::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTextView::toggle-overwrite ##### -->
+<para>
+
+</para>
+
+@textview: the object which received the signal.
+
+<!-- ##### ARG GtkTextView:accepts-tab ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:buffer ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:cursor-visible ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:editable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:indent ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:justification ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:left-margin ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:overwrite ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:pixels-above-lines ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:pixels-below-lines ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:pixels-inside-wrap ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:right-margin ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:tabs ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTextView:wrap-mode ##### -->
+<para>
+
+</para>
+
</para>
+<!-- ##### FUNCTION gtk_tips_query_new ##### -->
+<para>
+Creates a new #GtkTipsQuery.
+</para>
+
+@Returns: a new #GtkTipsQuery.
+
+
+<!-- ##### FUNCTION gtk_tips_query_start_query ##### -->
+<para>
+Starts a query.
+The #GtkTipsQuery widget will take control of the mouse and as the mouse
+moves it will display the tooltip of the widget beneath the mouse.
+</para>
+
+@tips_query: a #GtkTipsQuery.
+
+
+<!-- ##### FUNCTION gtk_tips_query_stop_query ##### -->
+<para>
+Stops a query.
+</para>
+
+@tips_query: a #GtkTipsQuery.
+
+
+<!-- ##### FUNCTION gtk_tips_query_set_caller ##### -->
+<para>
+Sets the widget which initiates the query, usually a button.
+If the @caller is selected while the query is running, the query is
+automatically stopped.
+</para>
+
+@tips_query: a #GtkTipsQuery.
+@caller: the widget which initiates the query.
+
+
+<!-- ##### FUNCTION gtk_tips_query_set_labels ##### -->
+<para>
+Sets the text to display when the query is not in effect,
+and the text to display when the query is in effect but the widget beneath
+the pointer has no tooltip.
+</para>
+
+@tips_query: a #GtkTipsQuery.
+@label_inactive: the text to display when the query is not running.
+@label_no_tip: the text to display when the query is running but the widget
+beneath the pointer has no tooltip.
+
+
<!-- ##### SIGNAL GtkTipsQuery::start-query ##### -->
<para>
Emitted when the query is started.
and the widget that the pointer is over has no tooltip.
</para>
-<!-- ##### FUNCTION gtk_tips_query_new ##### -->
-<para>
-Creates a new #GtkTipsQuery.
-</para>
-
-@Returns: a new #GtkTipsQuery.
-
-
-<!-- ##### FUNCTION gtk_tips_query_start_query ##### -->
-<para>
-Starts a query.
-The #GtkTipsQuery widget will take control of the mouse and as the mouse
-moves it will display the tooltip of the widget beneath the mouse.
-</para>
-
-@tips_query: a #GtkTipsQuery.
-
-
-<!-- ##### FUNCTION gtk_tips_query_stop_query ##### -->
-<para>
-Stops a query.
-</para>
-
-@tips_query: a #GtkTipsQuery.
-
-
-<!-- ##### FUNCTION gtk_tips_query_set_caller ##### -->
-<para>
-Sets the widget which initiates the query, usually a button.
-If the @caller is selected while the query is running, the query is
-automatically stopped.
-</para>
-
-@tips_query: a #GtkTipsQuery.
-@caller: the widget which initiates the query.
-
-
-<!-- ##### FUNCTION gtk_tips_query_set_labels ##### -->
-<para>
-Sets the text to display when the query is not in effect,
-and the text to display when the query is in effect but the widget beneath
-the pointer has no tooltip.
-</para>
-
-@tips_query: a #GtkTipsQuery.
-@label_inactive: the text to display when the query is not running.
-@label_no_tip: the text to display when the query is running but the widget
-beneath the pointer has no tooltip.
-
-
</para>
-<!-- ##### SIGNAL GtkToggleAction::toggled ##### -->
-<para>
-
-</para>
-
-@toggleaction: the object which received the signal.
-
-<!-- ##### ARG GtkToggleAction:draw-as-radio ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_toggle_action_toggled ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkToggleAction::toggled ##### -->
+<para>
+
+</para>
+
+@toggleaction: the object which received the signal.
+
+<!-- ##### ARG GtkToggleAction:draw-as-radio ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkToggleButton::toggled ##### -->
-<para>
-Should be connected if you wish to perform an action whenever the
-#GtkToggleButton's state is changed.
-</para>
-
-@togglebutton: the object which received the signal.
-
-<!-- ##### ARG GtkToggleButton:active ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToggleButton:draw-indicator ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToggleButton:inconsistent ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_toggle_button_new ##### -->
<para>
Creates a new toggle button. A widget should be packed into the button, as in gtk_button_new().
@setting:
+<!-- ##### SIGNAL GtkToggleButton::toggled ##### -->
+<para>
+Should be connected if you wish to perform an action whenever the
+#GtkToggleButton's state is changed.
+</para>
+
+@togglebutton: the object which received the signal.
+
+<!-- ##### ARG GtkToggleButton:active ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToggleButton:draw-indicator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToggleButton:inconsistent ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkToggleToolButton::toggled ##### -->
-<para>
-
-</para>
-
-@toggletoolbutton: the object which received the signal.
-
<!-- ##### FUNCTION gtk_toggle_tool_button_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkToggleToolButton::toggled ##### -->
+<para>
+
+</para>
+
+@toggletoolbutton: the object which received the signal.
+
A toolbar can contain instances of a subclass of #GtkToolItem. To add
a #GtkToolItem to the a toolbar, use gtk_toolbar_insert(). To remove
an item from the toolbar use gtk_container_remove(). To add a button
-to the toolbar, add an instance of #GtkToolButton. Toolbar items can
-be visually grouped by adding instances of #GtkSeparatorToolItem to
-the toolbar.
+to the toolbar, add an instance of #GtkToolButton.
+</para>
+<para>
+Toolbar items can be visually grouped by adding instances of
+#GtkSeparatorToolItem to the toolbar. If a #GtkSeparatorToolItem has
+the "expand" property set to #TRUE and the "draw" property set to
+#FALSE the effect is to force all following items to the end of the
+toolbar.
</para>
<para>
Creating a context menu for the toolbar can be done by connecting to
</para>
-<!-- ##### SIGNAL GtkToolbar::focus-home-or-end ##### -->
-<para>
-
-</para>
-
-@toolbar: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkToolbar::move-focus ##### -->
-<para>
-
-</para>
-
-@toolbar: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkToolbar::orientation-changed ##### -->
-<para>
-
-</para>
-
-@toolbar: the object which received the signal.
-@orientation: the new #GtkOrientation of the toolbar.
-
-<!-- ##### SIGNAL GtkToolbar::popup-context-menu ##### -->
-<para>
-
-</para>
-
-@toolbar: the object which received the signal.
-@Returns:
-@:
-@:
-@Returns:
-@:
-@Returns:
-@Returns:
-
-<!-- ##### SIGNAL GtkToolbar::style-changed ##### -->
-<para>
-
-</para>
-
-@toolbar:
-@style:
-
-<!-- ##### ARG GtkToolbar:orientation ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:show-arrow ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:toolbar-style ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:expand ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:homogeneous ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:pack-end ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:button-relief ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:internal-padding ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:space-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolbar:space-style ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkToolbarChildType ##### -->
<para>
#GtkToolbarChildType is used to set the type of new elements that are added
@toolbar:
+<!-- ##### SIGNAL GtkToolbar::focus-home-or-end ##### -->
+<para>
+
+</para>
+
+@toolbar: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkToolbar::move-focus ##### -->
+<para>
+
+</para>
+
+@toolbar: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkToolbar::orientation-changed ##### -->
+<para>
+
+</para>
+
+@toolbar: the object which received the signal.
+@orientation: the new #GtkOrientation of the toolbar.
+
+<!-- ##### SIGNAL GtkToolbar::popup-context-menu ##### -->
+<para>
+
+</para>
+
+@toolbar: the object which received the signal.
+@Returns:
+@:
+@:
+@Returns:
+@:
+@Returns:
+@Returns:
+
+<!-- ##### SIGNAL GtkToolbar::style-changed ##### -->
+<para>
+
+</para>
+
+@toolbar:
+@style:
+
+<!-- ##### ARG GtkToolbar:orientation ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:show-arrow ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:toolbar-style ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:expand ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:homogeneous ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:button-relief ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:internal-padding ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:shadow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:space-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolbar:space-style ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkToolButton::clicked ##### -->
-<para>
-
-</para>
-
-@toolbutton: the object which received the signal.
-
-<!-- ##### ARG GtkToolButton:icon-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolButton:label ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolButton:label-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolButton:stock-id ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolButton:use-underline ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_tool_button_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkToolButton::clicked ##### -->
+<para>
+
+</para>
+
+@toolbutton: the object which received the signal.
+
+<!-- ##### ARG GtkToolButton:icon-widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolButton:label ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolButton:label-widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolButton:stock-id ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolButton:use-underline ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkToolItem::create-menu-proxy ##### -->
-<para>
-
-</para>
-
-@toolitem: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkToolItem::set-tooltip ##### -->
-<para>
-
-</para>
-
-@toolitem: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-@Returns:
-
-<!-- ##### SIGNAL GtkToolItem::toolbar-reconfigured ##### -->
-<para>
-
-</para>
-
-@toolitem: the object which received the signal.
-
-<!-- ##### ARG GtkToolItem:is-important ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolItem:visible-horizontal ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkToolItem:visible-vertical ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_tool_item_new ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION gtk_tool_item_set_pack_end ##### -->
-<para>
-
-</para>
-
-@tool_item:
-@pack_end:
-
-
-<!-- ##### FUNCTION gtk_tool_item_get_pack_end ##### -->
-<para>
-
-</para>
-
-@tool_item:
-@Returns:
-
-
<!-- ##### FUNCTION gtk_tool_item_set_tooltip ##### -->
<para>
@menu_item:
+<!-- ##### SIGNAL GtkToolItem::create-menu-proxy ##### -->
+<para>
+
+</para>
+
+@toolitem: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkToolItem::set-tooltip ##### -->
+<para>
+
+</para>
+
+@toolitem: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+@Returns:
+
+<!-- ##### SIGNAL GtkToolItem::toolbar-reconfigured ##### -->
+<para>
+
+</para>
+
+@toolitem: the object which received the signal.
+
+<!-- ##### ARG GtkToolItem:is-important ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolItem:visible-horizontal ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkToolItem:visible-vertical ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkTree::select-child ##### -->
-<para>
-This signal is emitted by @tree whenever @widget is about to be selected.
-</para>
-
-@tree: the object which received the signal.
-@widget: The child that is about to be selected.
-
-<!-- ##### SIGNAL GtkTree::selection-changed ##### -->
-<para>
-This signal is emitted by the root tree whenever the selection changes.
-</para>
-
-@tree: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTree::unselect-child ##### -->
-<para>
-This signal is emitted by @tree whenever @widget is about to be unselected.
-</para>
-
-@tree: the object which received the signal.
-@widget: The child that is about to be unselected.
-
<!-- ##### MACRO GTK_IS_ROOT_TREE ##### -->
<para>
A macro that returns a boolean value which indicates if @obj is a root tree or not.
@child: A pointer to the #GtkWidget that is to be removed from the tree.
+<!-- ##### SIGNAL GtkTree::select-child ##### -->
+<para>
+This signal is emitted by @tree whenever @widget is about to be selected.
+</para>
+
+@tree: the object which received the signal.
+@widget: The child that is about to be selected.
+
+<!-- ##### SIGNAL GtkTree::selection-changed ##### -->
+<para>
+This signal is emitted by the root tree whenever the selection changes.
+</para>
+
+@tree: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTree::unselect-child ##### -->
+<para>
+This signal is emitted by @tree whenever @widget is about to be unselected.
+</para>
+
+@tree: the object which received the signal.
+@widget: The child that is about to be unselected.
+
</para>
-<!-- ##### SIGNAL GtkTreeItem::collapse ##### -->
-<para>
-
-</para>
-
-@treeitem: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTreeItem::expand ##### -->
-<para>
-
-</para>
-
-@treeitem: the object which received the signal.
-
<!-- ##### MACRO GTK_TREE_ITEM_SUBTREE ##### -->
<para>
@tree_item:
+<!-- ##### SIGNAL GtkTreeItem::collapse ##### -->
+<para>
+
+</para>
+
+@treeitem: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTreeItem::expand ##### -->
+<para>
+
+</para>
+
+@treeitem: the object which received the signal.
+
</para>
-<!-- ##### SIGNAL GtkTreeModel::row-changed ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeModel::row-deleted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkTreeModel::row-has-child-toggled ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeModel::row-inserted ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeModel::rows-reordered ##### -->
-<para>
-
-</para>
-
-@treemodel: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-
<!-- ##### STRUCT GtkTreeIter ##### -->
<para>
The <structname>GtkTreeIter</structname> is the primary structure for
@new_order:
+<!-- ##### SIGNAL GtkTreeModel::row-changed ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeModel::row-deleted ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkTreeModel::row-has-child-toggled ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeModel::row-inserted ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeModel::rows-reordered ##### -->
+<para>
+
+</para>
+
+@treemodel: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
</para>
-<!-- ##### ARG GtkTreeModelFilter:child-model ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeModelFilter:virtual-root ##### -->
-<para>
-
-</para>
-
<!-- ##### USER_FUNCTION GtkTreeModelFilterVisibleFunc ##### -->
<para>
@filter:
+<!-- ##### ARG GtkTreeModelFilter:child-model ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeModelFilter:virtual-root ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### ARG GtkTreeModelSort:model ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_tree_model_sort_new_with_model ##### -->
<para>
@Returns:
+<!-- ##### ARG GtkTreeModelSort:model ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkTreeSelection::changed ##### -->
-<para>
-Emitted whenever the selection has (possibly) changed. Please note that
-this signal is mostly a hint. It may only be emitted once when a range
-of rows are selected, and it may occasionally be emitted when nothing
-has happened.
-</para>
-
-@treeselection: the object which received the signal.
-
<!-- ##### USER_FUNCTION GtkTreeSelectionFunc ##### -->
<para>
A function used by gtk_tree_selection_set_select_function() to filter
@end_path:
+<!-- ##### SIGNAL GtkTreeSelection::changed ##### -->
+<para>
+Emitted whenever the selection has (possibly) changed. Please note that
+this signal is mostly a hint. It may only be emitted once when a range
+of rows are selected, and it may occasionally be emitted when nothing
+has happened.
+</para>
+
+@treeselection: the object which received the signal.
+
</para>
-<!-- ##### SIGNAL GtkTreeSortable::sort-column-changed ##### -->
-<para>
-
-</para>
-
-@treesortable: the object which received the signal.
-
<!-- ##### STRUCT GtkTreeSortableIface ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkTreeSortable::sort-column-changed ##### -->
+<para>
+
+</para>
+
+@treesortable: the object which received the signal.
+
</para>
-<!-- ##### SIGNAL GtkTreeView::columns-changed ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTreeView::cursor-changed ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-
-<!-- ##### SIGNAL GtkTreeView::expand-collapse-cursor-row ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-@arg3:
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::move-cursor ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::row-activated ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeView::row-collapsed ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeView::row-expanded ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeView::select-all ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::select-cursor-parent ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::select-cursor-row ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### SIGNAL GtkTreeView::start-interactive-search ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::test-collapse-row ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::test-expand-row ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@arg1:
-@arg2:
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::toggle-cursor-row ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@Returns:
-
-<!-- ##### SIGNAL GtkTreeView::unselect-all ##### -->
-<para>
-
-</para>
-
-@treeview: the object which received the signal.
-@Returns:
-
-<!-- ##### ARG GtkTreeView:enable-search ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:expander-column ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:hadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:headers-clickable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:headers-visible ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:model ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:reorderable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:rules-hint ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:search-column ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:vadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:allow-rules ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:even-row-color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:expander-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:horizontal-separator ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:odd-row-color ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeView:vertical-separator ##### -->
-<para>
-
-</para>
-
<!-- ##### ENUM GtkTreeViewDropPosition ##### -->
<para>
An enum for determining where a dropped row goes.
@destroy:
+<!-- ##### SIGNAL GtkTreeView::columns-changed ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTreeView::cursor-changed ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+
+<!-- ##### SIGNAL GtkTreeView::expand-collapse-cursor-row ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::move-cursor ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::row-activated ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeView::row-collapsed ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeView::row-expanded ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeView::select-all ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::select-cursor-parent ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::select-cursor-row ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GtkTreeView::start-interactive-search ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::test-collapse-row ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::test-expand-row ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@arg1:
+@arg2:
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::toggle-cursor-row ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL GtkTreeView::unselect-all ##### -->
+<para>
+
+</para>
+
+@treeview: the object which received the signal.
+@Returns:
+
+<!-- ##### ARG GtkTreeView:enable-search ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:expander-column ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:hadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:headers-clickable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:headers-visible ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:model ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:reorderable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:rules-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:search-column ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:vadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:allow-rules ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:even-row-color ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:expander-size ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:horizontal-separator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:indent-expanders ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:odd-row-color ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeView:vertical-separator ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
-<para>
-
-</para>
-
-@treeviewcolumn: the object which received the signal.
-
-<!-- ##### ARG GtkTreeViewColumn:alignment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:clickable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:expand ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:fixed-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:max-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:min-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:reorderable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:resizable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:sizing ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:sort-indicator ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:sort-order ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:visible ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkTreeViewColumn:width ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_tree_view_column_new ##### -->
<para>
@cell:
+<!-- ##### SIGNAL GtkTreeViewColumn::clicked ##### -->
+<para>
+
+</para>
+
+@treeviewcolumn: the object which received the signal.
+
+<!-- ##### ARG GtkTreeViewColumn:alignment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:clickable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:expand ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:fixed-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:max-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:min-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:reorderable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:resizable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:sizing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:sort-indicator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:sort-order ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:visible ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:widget ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkTreeViewColumn:width ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkUIManager::actions-changed ##### -->
-<para>
-
-</para>
-
-@uimanager: the object which received the signal.
-
-<!-- ##### SIGNAL GtkUIManager::add-widget ##### -->
-<para>
-
-</para>
-
-@uimanager: the object which received the signal.
-@widget:
-
-<!-- ##### ARG GtkUIManager:add-tearoffs ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkUIManager:ui ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_ui_manager_new ##### -->
<para>
@self:
+<!-- ##### SIGNAL GtkUIManager::actions-changed ##### -->
+<para>
+
+</para>
+
+@uimanager: the object which received the signal.
+
+<!-- ##### SIGNAL GtkUIManager::add-widget ##### -->
+<para>
+
+</para>
+
+@uimanager: the object which received the signal.
+@widget:
+
+<!-- ##### ARG GtkUIManager:add-tearoffs ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkUIManager:ui ##### -->
+<para>
+
+</para>
+
</para>
-<!-- ##### SIGNAL GtkViewport::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@viewport: the object which received the signal.
-@arg1:
-@arg2:
-
-<!-- ##### ARG GtkViewport:hadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkViewport:shadow-type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkViewport:vadjustment ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_viewport_new ##### -->
<para>
@Returns:
+<!-- ##### SIGNAL GtkViewport::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@viewport: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GtkViewport:hadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkViewport:shadow-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkViewport:vadjustment ##### -->
+<para>
+
+</para>
+
will be indicated by the #GTK_NO_WINDOW flag being set).
@parent:
-<!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
+<!-- ##### STRUCT GtkWidgetClass ##### -->
<para>
+<structfield>activate_signal</structfield>
+The signal to emit when a widget of this class is activated,
+gtk_widget_activate() handles the emission. Implementation of this
+signal is optional.
+</para>
+<para>
+<structfield>set_scroll_adjustment_signal</structfield>
+This signal is emitted when a widget of this class is added
+to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
+handles the emission.
+Implementation of this signal is optional.
</para>
-@widget: the object which received the signal.
+@parent_class:
+@activate_signal:
+@set_scroll_adjustments_signal:
-<!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
+<!-- ##### ENUM GtkWidgetFlags ##### -->
<para>
-
+Tells about certain properties of the widget.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@GTK_TOPLEVEL:
+ widgets without a real parent, as there are #GtkWindow<!-- -->s and
+ #GtkMenu<!-- -->s have this flag set throughout their lifetime.
+ Toplevel widgets always contain their own #GdkWindow.
+@GTK_NO_WINDOW:
+ Indicative for a widget that does not provide its own #GdkWindow.
+ Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
+@GTK_REALIZED:
+ Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
+ A realized widget has an associated #GdkWindow.
+@GTK_MAPPED:
+ Set by gtk_widget_map(), unset by gtk_widget_unmap().
+ Only realized widgets can be mapped. It means that gdk_window_show()
+ has been called on the widgets window(s).
+@GTK_VISIBLE:
+ Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
+ widget will be mapped as soon as its parent is mapped.
+@GTK_SENSITIVE:
+ Set and unset by gtk_widget_set_sensitive().
+ The sensitivity of a widget determines whether it will receive
+ certain events (e.g. button or key presses). One premise for
+ the widgets sensitivity is to have this flag set.
+@GTK_PARENT_SENSITIVE:
+ Set and unset by gtk_widget_set_sensitive() operations on the
+ parents of the widget.
+ This is the second premise for the widgets sensitivity. Once
+ it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
+ effectively sensitive. This is expressed (and can be examined) by
+ the #GTK_WIDGET_IS_SENSITIVE macro.
+@GTK_CAN_FOCUS:
+ Determines whether a widget is able to handle focus grabs.
+@GTK_HAS_FOCUS:
+ Set by gtk_widget_grab_focus() for widgets that also
+ have %GTK_CAN_FOCUS set. The flag will be unset once another widget
+ grabs the focus.
+@GTK_CAN_DEFAULT:
+ The widget is allowed to receive the default action via
+ gtk_widget_grab_default().
+@GTK_HAS_DEFAULT:
+ The widget currently is receiving the default action.
+@GTK_HAS_GRAB:
+ Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
+ widget is in the grab_widgets stack, and will be the preferred one for
+ receiving events other than ones of cosmetic value.
+@GTK_RC_STYLE:
+ Indicates that the widgets style has been looked up through the rc
+ mechanism. It does not imply that the widget actually had a style
+ defined through the rc mechanism.
+@GTK_COMPOSITE_CHILD:
+ Indicates that the widget is a composite child of its parent; see
+ gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
+@GTK_NO_REPARENT:
+ Unused since before GTK+ 1.2, will be removed in a future version.
+@GTK_APP_PAINTABLE:
+ Set and unset by gtk_widget_set_app_paintable().
+ Must be set on widgets whose window the application directly draws on,
+ in order to keep GTK+ from overwriting the drawn stuff.
+@GTK_RECEIVES_DEFAULT:
+ The widget when focused will receive the default action and have
+ %GTK_HAS_DEFAULT set even if there is a different widget set as default.
+@GTK_DOUBLE_BUFFERED:
+ Set and unset by gtk_widget_set_double_buffered().
+ Indicates that exposes done on the widget should be double-buffered.
+@GTK_NO_SHOW_ALL:
-<!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
+<!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
<para>
-
+Gets the type of a widget.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::child-notify ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_STATE ##### -->
+<para>
+Returns the current state of the widget, as a #GtkStateType.
</para>
-@widget: the object which received the signal.
-@arg1:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::client-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
+<para>
+Returns the saved state of the widget, as a #GtkStateType.
+</para>
+<para>
+The saved state will be restored when a widget gets sensitive
+again, after it has been made insensitive with gtk_widget_set_state()
+or gtk_widget_set_sensitive().
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::configure-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
+<para>
+Returns the widget flags from @wid.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::delete-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
+<para>
+Evaluates to %TRUE if the widget is a toplevel widget.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
+<para>
+Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
+<para>
+Evaluates to %TRUE if the widget is realized.
</para>
-@widget: the object which received the signal.
-@arg1:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-begin ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
+<para>
+Evaluates to %TRUE if the widget is mapped.
</para>
-@widget: the object which received the signal.
-@drag_context:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-data-delete ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
+<para>
+Evaluates to %TRUE if the widget is visible.
</para>
-@widget: the object which received the signal.
-@drag_context:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-data-get ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
+<para>
+Evaluates to %TRUE if the widget is mapped and visible.
</para>
-@widget: the object which received the signal.
-@drag_context:
-@data:
-@info:
-@time:
-<!-- # Unused Parameters # -->
-@time_:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-data-received ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
+<para>
+Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
</para>
-@widget: the object which received the signal.
-@drag_context:
-@x:
-@y:
-@data:
-@info:
-@time:
-<!-- # Unused Parameters # -->
-@time_:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-drop ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
+<para>
+Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
</para>
-@widget: the object which received the signal.
-@drag_context:
-@x:
-@y:
-@time:
-@Returns:
-<!-- # Unused Parameters # -->
-@time_:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-end ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
+<para>
+Evaluates to %TRUE if the widget is effectively sensitive.
</para>
-@widget: the object which received the signal.
-@drag_context:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-leave ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
+<para>
+Evaluates to %TRUE if the widget is able to handle focus grabs.
</para>
-@widget: the object which received the signal.
-@drag_context:
-@time:
-<!-- # Unused Parameters # -->
-@time_:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::drag-motion ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_HAS_FOCUS ##### -->
+<para>
+Evaluates to %TRUE if the widget has grabbed the focus and no other
+widget has done so more recently.
</para>
-@widget: the object which received the signal.
-@drag_context:
-@x:
-@y:
-@time:
-@Returns:
-<!-- # Unused Parameters # -->
-@time_:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::enter-notify-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_CAN_DEFAULT ##### -->
+<para>
+Evaluates to %TRUE if the widget is allowed to receive the default action
+via gtk_widget_grab_default().
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_RECEIVES_DEFAULT ##### -->
+<para>
+Evaluates to %TRUE if the widget when focused will receive the default action
+even if there is a different widget set as default.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::event-after ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_HAS_DEFAULT ##### -->
+<para>
+Evaluates to %TRUE if the widget currently is receiving the default action.
</para>
-@widget: the object which received the signal.
-@event:
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::expose-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_HAS_GRAB ##### -->
+<para>
+Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be
+the preferred one for receiving events other than ones of cosmetic value.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::focus ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_RC_STYLE ##### -->
+<para>
+Evaluates to %TRUE if the widgets style has been looked up through the rc
+mechanism.
</para>
-@widget: the object which received the signal.
-@arg1:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_COMPOSITE_CHILD ##### -->
+<para>
+Evaluates to %TRUE if the widget is a composite child of its parent.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_APP_PAINTABLE ##### -->
+<para>
+Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget.
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
-<para>
+<!-- ##### MACRO GTK_WIDGET_DOUBLE_BUFFERED ##### -->
+<para>
+Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget.
</para>
-@widget: the object which received the signal.
+@wid: a #GtkWidget.
-<!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
+
+<!-- ##### MACRO GTK_WIDGET_SET_FLAGS ##### -->
<para>
+Turns on certain widget flags.
+</para>
+
+@wid: a #GtkWidget.
+@flag: the flags to set.
+
+<!-- ##### MACRO GTK_WIDGET_UNSET_FLAGS ##### -->
+<para>
+Turns off certain widget flags.
</para>
-@widget: the object which received the signal.
-@arg1:
+@wid: a #GtkWidget.
+@flag: the flags to unset.
-<!-- ##### SIGNAL GtkWidget::hide ##### -->
+
+<!-- ##### USER_FUNCTION GtkCallback ##### -->
<para>
+The type of the callback functions used for e.g. iterating over
+the children of a container, see gtk_container_foreach().
+</para>
+
+@widget: the widget to operate on
+@data: user-supplied data
+
+<!-- ##### STRUCT GtkRequisition ##### -->
+<para>
+A <structname>GtkRequisition</structname> represents the desired size of a widget. See
+<xref linkend="size-requisition"/> for more information.
</para>
-@widget: the object which received the signal.
+@width: the widget's desired width
+@height: the widget's desired height
-<!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
+<!-- ##### STRUCT GtkAllocation ##### -->
<para>
-Emitted when there is a chance in the hierarchy to
-which a widget belong. More precisely, a widget is
-<firstterm>anchored</firstterm> when its toplevel
-ancestor is a #GtkWindow. This signal is emitted when
-a widget changes from un-anchored to anchored or vice-versa.
+A <structname>GtkAllocation</structname> of a widget represents region which has been allocated to the
+widget by its parent. It is a subregion of its parents allocation. See
+<xref linkend="size-allocation"/> for more information.
</para>
-@widget: the object which received the signal.
-@widget2:
+@x: the X position of the widgets area relative to its parents allocation.
+@y: the Y position of the widgets area relative to its parents allocation.
+@width: the width of the widgets allocated area.
+@height: the height of the widgets allocated area.
-<!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
+<!-- ##### STRUCT GtkSelectionData ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@selection:
+@target:
+@type:
+@format:
+@data:
+@length:
+@display:
-<!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
+<!-- ##### STRUCT GtkWidgetAuxInfo ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@x:
+@y:
+@width:
+@height:
+@x_set:
+@y_set:
-<!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
+<!-- ##### STRUCT GtkWidgetShapeInfo ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@offset_x:
+@offset_y:
+@shape_mask:
-<!-- ##### SIGNAL GtkWidget::map ##### -->
+<!-- ##### ENUM GtkWidgetHelpType ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@GTK_WIDGET_HELP_TOOLTIP:
+@GTK_WIDGET_HELP_WHATS_THIS:
-<!-- ##### SIGNAL GtkWidget::map-event ##### -->
+<!-- ##### FUNCTION gtk_widget_new ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@type:
+@first_property_name:
+@Varargs:
+@Returns:
+<!-- # Unused Parameters # -->
+@first_arg_name:
-<!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
+
+<!-- ##### FUNCTION gtk_widget_ref ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@arg1:
+@widget:
@Returns:
-<!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_unref ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_destroy ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::parent-set ##### -->
+
+<!-- ##### FUNCTION gtk_widget_destroyed ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@old_parent:
+@widget:
+@widget_pointer:
-<!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
+
+<!-- ##### FUNCTION gtk_widget_set ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@Returns:
+@widget:
+@first_property_name:
+@Varargs:
+<!-- # Unused Parameters # -->
+@first_arg_name:
-<!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_unparent ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_show ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_show_now ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::realize ##### -->
+
+<!-- ##### FUNCTION gtk_widget_hide ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
-<!-- ##### SIGNAL GtkWidget::screen-changed ##### -->
+
+<!-- ##### FUNCTION gtk_widget_show_all ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@arg1:
+@widget:
-<!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_hide_all ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_map ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::selection-get ##### -->
+
+<!-- ##### FUNCTION gtk_widget_unmap ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@data:
-@info:
-@time:
-<!-- # Unused Parameters # -->
-@time_:
+@widget:
-<!-- ##### SIGNAL GtkWidget::selection-notify-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_realize ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::selection-received ##### -->
+
+<!-- ##### FUNCTION gtk_widget_unrealize ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@data:
-@time:
-<!-- # Unused Parameters # -->
-@time_:
+@widget:
-<!-- ##### SIGNAL GtkWidget::selection-request-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_queue_draw ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
-<!-- ##### SIGNAL GtkWidget::show ##### -->
+
+<!-- ##### FUNCTION gtk_widget_queue_resize ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
-<!-- ##### SIGNAL GtkWidget::show-help ##### -->
+
+<!-- ##### FUNCTION gtk_widget_queue_resize_no_redraw ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@arg1:
-@Returns:
+@widget:
-<!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
+
+<!-- ##### FUNCTION gtk_widget_draw ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@allocation:
+@widget:
+@area:
-<!-- ##### SIGNAL GtkWidget::size-request ##### -->
+
+<!-- ##### FUNCTION gtk_widget_size_request ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
@requisition:
-<!-- ##### SIGNAL GtkWidget::state-changed ##### -->
+
+<!-- ##### FUNCTION gtk_widget_get_child_requisition ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@state:
+@widget:
+@requisition:
-<!-- ##### SIGNAL GtkWidget::style-set ##### -->
+
+<!-- ##### FUNCTION gtk_widget_size_allocate ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@previous_style:
+@widget:
+@allocation:
-<!-- ##### SIGNAL GtkWidget::unmap ##### -->
+
+<!-- ##### FUNCTION gtk_widget_add_accelerator ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
+@accel_signal:
+@accel_group:
+@accel_key:
+@accel_mods:
+@accel_flags:
-<!-- ##### SIGNAL GtkWidget::unmap-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_remove_accelerator ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
+@accel_group:
+@accel_key:
+@accel_mods:
+@Returns:
-<!-- ##### SIGNAL GtkWidget::unrealize ##### -->
+
+<!-- ##### FUNCTION gtk_widget_set_accel_path ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
+@accel_path:
+@accel_group:
-<!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_list_accel_closures ##### -->
<para>
</para>
-@widget: the object which received the signal.
-@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@widget:
+@Returns:
-<!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
+
+<!-- ##### FUNCTION gtk_widget_event ##### -->
<para>
</para>
-@widget: the object which received the signal.
+@widget:
@event:
-@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
+@Returns:
-<!-- ##### ARG GtkWidget:app-paintable ##### -->
+
+<!-- ##### FUNCTION gtk_widget_activate ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:can-default ##### -->
-<para>
+@widget:
+@Returns:
-</para>
-<!-- ##### ARG GtkWidget:can-focus ##### -->
+<!-- ##### FUNCTION gtk_widget_reparent ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:composite-child ##### -->
-<para>
+@widget:
+@new_parent:
-</para>
-<!-- ##### ARG GtkWidget:events ##### -->
+<!-- ##### FUNCTION gtk_widget_intersect ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:extension-events ##### -->
-<para>
+@widget:
+@area:
+@intersection:
+@Returns:
-</para>
-<!-- ##### ARG GtkWidget:has-default ##### -->
+<!-- ##### FUNCTION gtk_widget_is_focus ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:has-focus ##### -->
-<para>
+@widget:
+@Returns:
-</para>
-<!-- ##### ARG GtkWidget:height-request ##### -->
+<!-- ##### FUNCTION gtk_widget_grab_focus ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:is-focus ##### -->
-<para>
+@widget:
-</para>
-<!-- ##### ARG GtkWidget:name ##### -->
+<!-- ##### FUNCTION gtk_widget_grab_default ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:no-show-all ##### -->
-<para>
+@widget:
-</para>
-<!-- ##### ARG GtkWidget:parent ##### -->
+<!-- ##### FUNCTION gtk_widget_set_name ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:receives-default ##### -->
+@widget:
+@name:
+
+
+<!-- ##### FUNCTION gtk_widget_get_name ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:sensitive ##### -->
+@widget:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_set_state ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:style ##### -->
+@widget:
+@state:
+
+
+<!-- ##### FUNCTION gtk_widget_set_sensitive ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:visible ##### -->
-<para>
+@widget:
+@sensitive:
-</para>
-<!-- ##### ARG GtkWidget:width-request ##### -->
+<!-- ##### FUNCTION gtk_widget_set_parent ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
-<para>
+@widget:
+@parent:
-</para>
-<!-- ##### ARG GtkWidget:cursor-color ##### -->
+<!-- ##### FUNCTION gtk_widget_set_parent_window ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
-<para>
+@widget:
+@parent_window:
-</para>
-<!-- ##### ARG GtkWidget:focus-line-width ##### -->
+<!-- ##### FUNCTION gtk_widget_get_parent_window ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:focus-padding ##### -->
-<para>
+@widget:
+@Returns:
-</para>
-<!-- ##### ARG GtkWidget:interior-focus ##### -->
+<!-- ##### FUNCTION gtk_widget_set_uposition ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
-<para>
+@widget:
+@x:
+@y:
-</para>
-<!-- ##### STRUCT GtkWidgetClass ##### -->
+<!-- ##### FUNCTION gtk_widget_set_usize ##### -->
<para>
-<structfield>activate_signal</structfield>
-The signal to emit when a widget of this class is activated,
-gtk_widget_activate() handles the emission. Implementation of this
-signal is optional.
-</para>
-<para>
-<structfield>set_scroll_adjustment_signal</structfield>
-This signal is emitted when a widget of this class is added
-to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
-handles the emission.
-Implementation of this signal is optional.
</para>
-@parent_class:
-@activate_signal:
-@set_scroll_adjustments_signal:
+@widget:
+@width:
+@height:
-<!-- ##### ENUM GtkWidgetFlags ##### -->
+
+<!-- ##### FUNCTION gtk_widget_set_events ##### -->
<para>
-Tells about certain properties of the widget.
+
</para>
-@GTK_TOPLEVEL:
- widgets without a real parent, as there are #GtkWindow<!-- -->s and
- #GtkMenu<!-- -->s have this flag set throughout their lifetime.
- Toplevel widgets always contain their own #GdkWindow.
-@GTK_NO_WINDOW:
- Indicative for a widget that does not provide its own #GdkWindow.
- Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
-@GTK_REALIZED:
- Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
- A realized widget has an associated #GdkWindow.
-@GTK_MAPPED:
- Set by gtk_widget_map(), unset by gtk_widget_unmap().
- Only realized widgets can be mapped. It means that gdk_window_show()
- has been called on the widgets window(s).
-@GTK_VISIBLE:
- Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
- widget will be mapped as soon as its parent is mapped.
-@GTK_SENSITIVE:
- Set and unset by gtk_widget_set_sensitive().
- The sensitivity of a widget determines whether it will receive
- certain events (e.g. button or key presses). One premise for
- the widgets sensitivity is to have this flag set.
-@GTK_PARENT_SENSITIVE:
- Set and unset by gtk_widget_set_sensitive() operations on the
- parents of the widget.
- This is the second premise for the widgets sensitivity. Once
- it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
- effectively sensitive. This is expressed (and can be examined) by
- the #GTK_WIDGET_IS_SENSITIVE macro.
-@GTK_CAN_FOCUS:
- Determines whether a widget is able to handle focus grabs.
-@GTK_HAS_FOCUS:
- Set by gtk_widget_grab_focus() for widgets that also
- have %GTK_CAN_FOCUS set. The flag will be unset once another widget
- grabs the focus.
-@GTK_CAN_DEFAULT:
- The widget is allowed to receive the default action via
- gtk_widget_grab_default().
-@GTK_HAS_DEFAULT:
- The widget currently is receiving the default action.
-@GTK_HAS_GRAB:
- Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
- widget is in the grab_widgets stack, and will be the preferred one for
- receiving events other than ones of cosmetic value.
-@GTK_RC_STYLE:
- Indicates that the widgets style has been looked up through the rc
- mechanism. It does not imply that the widget actually had a style
- defined through the rc mechanism.
-@GTK_COMPOSITE_CHILD:
- Indicates that the widget is a composite child of its parent; see
- gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
-@GTK_NO_REPARENT:
- Unused since before GTK+ 1.2, will be removed in a future version.
-@GTK_APP_PAINTABLE:
- Set and unset by gtk_widget_set_app_paintable().
- Must be set on widgets whose window the application directly draws on,
- in order to keep GTK+ from overwriting the drawn stuff.
-@GTK_RECEIVES_DEFAULT:
- The widget when focused will receive the default action and have
- %GTK_HAS_DEFAULT set even if there is a different widget set as default.
-@GTK_DOUBLE_BUFFERED:
- Set and unset by gtk_widget_set_double_buffered().
- Indicates that exposes done on the widget should be double-buffered.
-@GTK_NO_SHOW_ALL:
+@widget:
+@events:
-<!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
+
+<!-- ##### FUNCTION gtk_widget_add_events ##### -->
<para>
-Gets the type of a widget.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@events:
-<!-- ##### MACRO GTK_WIDGET_STATE ##### -->
+<!-- ##### FUNCTION gtk_widget_set_extension_events ##### -->
<para>
-Returns the current state of the widget, as a #GtkStateType.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@mode:
-<!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
-<para>
-Returns the saved state of the widget, as a #GtkStateType.
-</para>
+<!-- ##### FUNCTION gtk_widget_get_extension_events ##### -->
<para>
-The saved state will be restored when a widget gets sensitive
-again, after it has been made insensitive with gtk_widget_set_state()
-or gtk_widget_set_sensitive().
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
+<!-- ##### FUNCTION gtk_widget_get_toplevel ##### -->
<para>
-Returns the widget flags from @wid.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
+<!-- ##### FUNCTION gtk_widget_get_ancestor ##### -->
<para>
-Evaluates to %TRUE if the widget is a toplevel widget.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@widget_type:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
+<!-- ##### FUNCTION gtk_widget_get_colormap ##### -->
<para>
-Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
+<!-- ##### FUNCTION gtk_widget_set_colormap ##### -->
<para>
-Evaluates to %TRUE if the widget is realized.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@colormap:
-<!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
+<!-- ##### FUNCTION gtk_widget_get_visual ##### -->
<para>
-Evaluates to %TRUE if the widget is mapped.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
+<!-- ##### FUNCTION gtk_widget_get_events ##### -->
<para>
-Evaluates to %TRUE if the widget is visible.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
+<!-- ##### FUNCTION gtk_widget_get_pointer ##### -->
<para>
-Evaluates to %TRUE if the widget is mapped and visible.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@x:
+@y:
-<!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
+<!-- ##### FUNCTION gtk_widget_is_ancestor ##### -->
<para>
-Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@ancestor:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
+<!-- ##### FUNCTION gtk_widget_translate_coordinates ##### -->
<para>
-Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
+
</para>
-@wid: a #GtkWidget.
+@src_widget:
+@dest_widget:
+@src_x:
+@src_y:
+@dest_x:
+@dest_y:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
+<!-- ##### FUNCTION gtk_widget_hide_on_delete ##### -->
<para>
-Evaluates to %TRUE if the widget is effectively sensitive.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
+<!-- ##### FUNCTION gtk_widget_set_style ##### -->
<para>
-Evaluates to %TRUE if the widget is able to handle focus grabs.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@style:
-<!-- ##### MACRO GTK_WIDGET_HAS_FOCUS ##### -->
+<!-- ##### MACRO gtk_widget_set_rc_style ##### -->
<para>
-Evaluates to %TRUE if the widget has grabbed the focus and no other
-widget has done so more recently.
+Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
</para>
-@wid: a #GtkWidget.
+@widget: a #GtkWidget.
-<!-- ##### MACRO GTK_WIDGET_CAN_DEFAULT ##### -->
+<!-- ##### FUNCTION gtk_widget_ensure_style ##### -->
<para>
-Evaluates to %TRUE if the widget is allowed to receive the default action
-via gtk_widget_grab_default().
+
</para>
-@wid: a #GtkWidget.
+@widget:
-<!-- ##### MACRO GTK_WIDGET_RECEIVES_DEFAULT ##### -->
+<!-- ##### FUNCTION gtk_widget_get_style ##### -->
<para>
-Evaluates to %TRUE if the widget when focused will receive the default action
-even if there is a different widget set as default.
+
</para>
-@wid: a #GtkWidget.
+@widget:
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_HAS_DEFAULT ##### -->
+<!-- ##### MACRO gtk_widget_restore_default_style ##### -->
<para>
-Evaluates to %TRUE if the widget currently is receiving the default action.
+Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
</para>
-@wid: a #GtkWidget.
+@widget: a #GtkWidget.
-<!-- ##### MACRO GTK_WIDGET_HAS_GRAB ##### -->
+<!-- ##### FUNCTION gtk_widget_reset_rc_styles ##### -->
<para>
-Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be
-the preferred one for receiving events other than ones of cosmetic value.
+Reset the styles of @widget and all descendents, so when
+they are looked up again, they get the correct values
+for the currently loaded RC file settings.
+</para>
+<para>
+This function is not useful for applications.
</para>
-@wid: a #GtkWidget.
+@widget: a #GtkWidget.
-<!-- ##### MACRO GTK_WIDGET_RC_STYLE ##### -->
+<!-- ##### FUNCTION gtk_widget_push_colormap ##### -->
<para>
-Evaluates to %TRUE if the widgets style has been looked up through the rc
-mechanism.
+
</para>
-@wid: a #GtkWidget.
+@cmap:
-<!-- ##### MACRO GTK_WIDGET_COMPOSITE_CHILD ##### -->
+<!-- ##### FUNCTION gtk_widget_pop_colormap ##### -->
<para>
-Evaluates to %TRUE if the widget is a composite child of its parent.
+
</para>
-@wid: a #GtkWidget.
-<!-- ##### MACRO GTK_WIDGET_APP_PAINTABLE ##### -->
+<!-- ##### FUNCTION gtk_widget_set_default_colormap ##### -->
<para>
-Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget.
+
</para>
-@wid: a #GtkWidget.
+@colormap:
-<!-- ##### MACRO GTK_WIDGET_DOUBLE_BUFFERED ##### -->
+<!-- ##### FUNCTION gtk_widget_get_default_style ##### -->
<para>
-Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget.
+
</para>
-@wid: a #GtkWidget.
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_SET_FLAGS ##### -->
+<!-- ##### FUNCTION gtk_widget_get_default_colormap ##### -->
<para>
-Turns on certain widget flags.
+
</para>
-@wid: a #GtkWidget.
-@flag: the flags to set.
+@Returns:
-<!-- ##### MACRO GTK_WIDGET_UNSET_FLAGS ##### -->
+<!-- ##### FUNCTION gtk_widget_get_default_visual ##### -->
<para>
-Turns off certain widget flags.
+
</para>
-@wid: a #GtkWidget.
-@flag: the flags to unset.
+@Returns:
-<!-- ##### USER_FUNCTION GtkCallback ##### -->
+<!-- ##### FUNCTION gtk_widget_set_direction ##### -->
<para>
-The type of the callback functions used for e.g. iterating over
-the children of a container, see gtk_container_foreach().
+
</para>
-@widget: the widget to operate on
-@data: user-supplied data
+@widget:
+@dir:
-<!-- ##### STRUCT GtkRequisition ##### -->
+<!-- ##### ENUM GtkTextDirection ##### -->
<para>
-A <structname>GtkRequisition</structname> represents the desired size of a widget. See
-<xref linkend="size-requisition"/> for more information.
+
</para>
-@width: the widget's desired width
-@height: the widget's desired height
+@GTK_TEXT_DIR_NONE:
+@GTK_TEXT_DIR_LTR:
+@GTK_TEXT_DIR_RTL:
-<!-- ##### STRUCT GtkAllocation ##### -->
+<!-- ##### FUNCTION gtk_widget_get_direction ##### -->
<para>
-A <structname>GtkAllocation</structname> of a widget represents region which has been allocated to the
-widget by its parent. It is a subregion of its parents allocation. See
-<xref linkend="size-allocation"/> for more information.
+
</para>
-@x: the X position of the widgets area relative to its parents allocation.
-@y: the Y position of the widgets area relative to its parents allocation.
-@width: the width of the widgets allocated area.
-@height: the height of the widgets allocated area.
+@widget:
+@Returns:
-<!-- ##### STRUCT GtkSelectionData ##### -->
+
+<!-- ##### FUNCTION gtk_widget_set_default_direction ##### -->
<para>
</para>
-@selection:
-@target:
-@type:
-@format:
-@data:
-@length:
-@display:
+@dir:
-<!-- ##### STRUCT GtkWidgetAuxInfo ##### -->
+
+<!-- ##### FUNCTION gtk_widget_get_default_direction ##### -->
<para>
</para>
-@x:
-@y:
-@width:
-@height:
-@x_set:
-@y_set:
+@Returns:
-<!-- ##### STRUCT GtkWidgetShapeInfo ##### -->
+
+<!-- ##### FUNCTION gtk_widget_shape_combine_mask ##### -->
<para>
</para>
+@widget:
+@shape_mask:
@offset_x:
@offset_y:
-@shape_mask:
-<!-- ##### ENUM GtkWidgetHelpType ##### -->
-<para>
-
-</para>
-@GTK_WIDGET_HELP_TOOLTIP:
-@GTK_WIDGET_HELP_WHATS_THIS:
-
-<!-- ##### FUNCTION gtk_widget_new ##### -->
+<!-- ##### FUNCTION gtk_widget_path ##### -->
<para>
</para>
-@type:
-@first_property_name:
-@Varargs:
-@Returns:
-<!-- # Unused Parameters # -->
-@first_arg_name:
+@widget:
+@path_length:
+@path:
+@path_reversed:
-<!-- ##### FUNCTION gtk_widget_ref ##### -->
+<!-- ##### FUNCTION gtk_widget_class_path ##### -->
<para>
</para>
@widget:
-@Returns:
+@path_length:
+@path:
+@path_reversed:
-<!-- ##### FUNCTION gtk_widget_unref ##### -->
+<!-- ##### FUNCTION gtk_widget_get_composite_name ##### -->
<para>
</para>
@widget:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_destroy ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_style ##### -->
<para>
</para>
@widget:
+@style:
-<!-- ##### FUNCTION gtk_widget_destroyed ##### -->
+<!-- ##### FUNCTION gtk_widget_get_modifier_style ##### -->
<para>
</para>
@widget:
-@widget_pointer:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_fg ##### -->
<para>
</para>
@widget:
-@first_property_name:
-@Varargs:
-<!-- # Unused Parameters # -->
-@first_arg_name:
+@state:
+@color:
-<!-- ##### FUNCTION gtk_widget_unparent ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_bg ##### -->
<para>
</para>
@widget:
+@state:
+@color:
-<!-- ##### FUNCTION gtk_widget_show ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_text ##### -->
<para>
</para>
@widget:
+@state:
+@color:
-<!-- ##### FUNCTION gtk_widget_show_now ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_base ##### -->
<para>
</para>
@widget:
+@state:
+@color:
-<!-- ##### FUNCTION gtk_widget_hide ##### -->
+<!-- ##### FUNCTION gtk_widget_modify_font ##### -->
<para>
</para>
@widget:
+@font_desc:
-<!-- ##### FUNCTION gtk_widget_show_all ##### -->
+<!-- ##### FUNCTION gtk_widget_create_pango_context ##### -->
<para>
</para>
@widget:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_hide_all ##### -->
+<!-- ##### FUNCTION gtk_widget_get_pango_context ##### -->
<para>
</para>
@widget:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_map ##### -->
+<!-- ##### FUNCTION gtk_widget_create_pango_layout ##### -->
<para>
</para>
@widget:
+@text:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_unmap ##### -->
+<!-- ##### FUNCTION gtk_widget_render_icon ##### -->
<para>
</para>
@widget:
+@stock_id:
+@size:
+@detail:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_realize ##### -->
+<!-- ##### FUNCTION gtk_widget_pop_composite_child ##### -->
<para>
</para>
-@widget:
-<!-- ##### FUNCTION gtk_widget_unrealize ##### -->
+<!-- ##### FUNCTION gtk_widget_push_composite_child ##### -->
<para>
</para>
-@widget:
-<!-- ##### FUNCTION gtk_widget_queue_draw ##### -->
+<!-- ##### FUNCTION gtk_widget_queue_clear ##### -->
<para>
</para>
@widget:
-<!-- ##### FUNCTION gtk_widget_queue_resize ##### -->
+<!-- ##### FUNCTION gtk_widget_queue_clear_area ##### -->
<para>
</para>
@widget:
+@x:
+@y:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_widget_queue_resize_no_redraw ##### -->
+<!-- ##### FUNCTION gtk_widget_queue_draw_area ##### -->
<para>
</para>
@widget:
+@x:
+@y:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_widget_draw ##### -->
+<!-- ##### FUNCTION gtk_widget_reset_shapes ##### -->
<para>
</para>
@widget:
-@area:
-<!-- ##### FUNCTION gtk_widget_size_request ##### -->
+<!-- ##### FUNCTION gtk_widget_set_app_paintable ##### -->
<para>
</para>
@widget:
-@requisition:
+@app_paintable:
-<!-- ##### FUNCTION gtk_widget_get_child_requisition ##### -->
+<!-- ##### FUNCTION gtk_widget_set_double_buffered ##### -->
<para>
</para>
@widget:
-@requisition:
+@double_buffered:
-<!-- ##### FUNCTION gtk_widget_size_allocate ##### -->
+<!-- ##### FUNCTION gtk_widget_set_redraw_on_allocate ##### -->
<para>
</para>
@widget:
-@allocation:
+@redraw_on_allocate:
-<!-- ##### FUNCTION gtk_widget_add_accelerator ##### -->
+<!-- ##### FUNCTION gtk_widget_set_composite_name ##### -->
<para>
</para>
@widget:
-@accel_signal:
-@accel_group:
-@accel_key:
-@accel_mods:
-@accel_flags:
+@name:
-<!-- ##### FUNCTION gtk_widget_remove_accelerator ##### -->
+<!-- ##### FUNCTION gtk_widget_set_scroll_adjustments ##### -->
<para>
</para>
@widget:
-@accel_group:
-@accel_key:
-@accel_mods:
+@hadjustment:
+@vadjustment:
@Returns:
-<!-- ##### FUNCTION gtk_widget_set_accel_path ##### -->
+<!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
<para>
</para>
@widget:
-@accel_path:
-@accel_group:
+@group_cycling:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_list_accel_closures ##### -->
+<!-- ##### FUNCTION gtk_widget_class_install_style_property ##### -->
<para>
</para>
-@widget:
-@Returns:
+@klass:
+@pspec:
+<!-- # Unused Parameters # -->
+@class:
-<!-- ##### FUNCTION gtk_widget_event ##### -->
+<!-- ##### FUNCTION gtk_widget_class_install_style_property_parser ##### -->
<para>
</para>
-@widget:
-@event:
-@Returns:
+@klass:
+@pspec:
+@parser:
+<!-- # Unused Parameters # -->
+@class:
-<!-- ##### FUNCTION gtk_widget_activate ##### -->
+<!-- ##### FUNCTION gtk_widget_class_find_style_property ##### -->
<para>
</para>
-@widget:
+@klass:
+@property_name:
@Returns:
+<!-- # Unused Parameters # -->
+@class:
-<!-- ##### FUNCTION gtk_widget_reparent ##### -->
+<!-- ##### FUNCTION gtk_widget_class_list_style_properties ##### -->
<para>
</para>
-@widget:
-@new_parent:
+@klass:
+@n_properties:
+@Returns:
+<!-- # Unused Parameters # -->
+@class:
-<!-- ##### FUNCTION gtk_widget_intersect ##### -->
+<!-- ##### FUNCTION gtk_widget_region_intersect ##### -->
<para>
</para>
@widget:
-@area:
-@intersection:
+@region:
@Returns:
-<!-- ##### FUNCTION gtk_widget_is_focus ##### -->
+<!-- ##### FUNCTION gtk_widget_send_expose ##### -->
<para>
</para>
@widget:
+@event:
@Returns:
-<!-- ##### FUNCTION gtk_widget_grab_focus ##### -->
+<!-- ##### FUNCTION gtk_widget_style_get ##### -->
<para>
</para>
@widget:
+@first_property_name:
+@Varargs:
-<!-- ##### FUNCTION gtk_widget_grab_default ##### -->
+<!-- ##### FUNCTION gtk_widget_style_get_property ##### -->
<para>
</para>
@widget:
+@property_name:
+@value:
-<!-- ##### FUNCTION gtk_widget_set_name ##### -->
+<!-- ##### FUNCTION gtk_widget_style_get_valist ##### -->
<para>
</para>
@widget:
-@name:
+@first_property_name:
+@var_args:
-<!-- ##### FUNCTION gtk_widget_get_name ##### -->
+<!-- ##### FUNCTION gtk_widget_get_accessible ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_set_state ##### -->
+<!-- ##### FUNCTION gtk_widget_child_focus ##### -->
<para>
</para>
@widget:
-@state:
+@direction:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set_sensitive ##### -->
+<!-- ##### FUNCTION gtk_widget_child_notify ##### -->
<para>
</para>
@widget:
-@sensitive:
+@child_property:
-<!-- ##### FUNCTION gtk_widget_set_parent ##### -->
+<!-- ##### FUNCTION gtk_widget_freeze_child_notify ##### -->
<para>
</para>
@widget:
-@parent:
-<!-- ##### FUNCTION gtk_widget_set_parent_window ##### -->
+<!-- ##### FUNCTION gtk_widget_get_child_visible ##### -->
<para>
</para>
@widget:
-@parent_window:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_get_parent_window ##### -->
+<!-- ##### FUNCTION gtk_widget_get_parent ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_set_uposition ##### -->
+<!-- ##### FUNCTION gtk_widget_get_settings ##### -->
<para>
</para>
@widget:
-@x:
-@y:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set_usize ##### -->
+<!-- ##### FUNCTION gtk_widget_get_clipboard ##### -->
<para>
</para>
@widget:
-@width:
-@height:
+@selection:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set_events ##### -->
+<!-- ##### FUNCTION gtk_widget_get_display ##### -->
<para>
</para>
@widget:
-@events:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_add_events ##### -->
+<!-- ##### FUNCTION gtk_widget_get_root_window ##### -->
<para>
</para>
@widget:
-@events:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set_extension_events ##### -->
+<!-- ##### FUNCTION gtk_widget_get_screen ##### -->
<para>
</para>
@widget:
-@mode:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_get_extension_events ##### -->
+<!-- ##### FUNCTION gtk_widget_has_screen ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_get_toplevel ##### -->
+<!-- ##### FUNCTION gtk_widget_get_size_request ##### -->
<para>
</para>
@widget:
-@Returns:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_widget_get_ancestor ##### -->
+<!-- ##### MACRO gtk_widget_pop_visual ##### -->
<para>
-
+This function is deprecated; it does nothing.
</para>
-@widget:
-@widget_type:
-@Returns:
-<!-- ##### FUNCTION gtk_widget_get_colormap ##### -->
+<!-- ##### MACRO gtk_widget_push_visual ##### -->
<para>
-
+This function is deprecated; it does nothing.
</para>
-@widget:
-@Returns:
+@visual:
-<!-- ##### FUNCTION gtk_widget_set_colormap ##### -->
+<!-- ##### FUNCTION gtk_widget_set_child_visible ##### -->
<para>
</para>
@widget:
-@colormap:
+@is_visible:
-<!-- ##### FUNCTION gtk_widget_get_visual ##### -->
+<!-- ##### MACRO gtk_widget_set_default_visual ##### -->
<para>
-
+This function is deprecated; it does nothing.
</para>
-@widget:
-@Returns:
+@visual:
-<!-- ##### FUNCTION gtk_widget_get_events ##### -->
+<!-- ##### FUNCTION gtk_widget_set_size_request ##### -->
<para>
</para>
@widget:
-@Returns:
+@width:
+@height:
-<!-- ##### FUNCTION gtk_widget_get_pointer ##### -->
+<!-- ##### MACRO gtk_widget_set_visual ##### -->
<para>
-
+This function is deprecated; it does nothing.
</para>
@widget:
-@x:
-@y:
+@visual:
-<!-- ##### FUNCTION gtk_widget_is_ancestor ##### -->
+<!-- ##### FUNCTION gtk_widget_thaw_child_notify ##### -->
<para>
</para>
@widget:
-@ancestor:
-@Returns:
-<!-- ##### FUNCTION gtk_widget_translate_coordinates ##### -->
+<!-- ##### FUNCTION gtk_widget_set_no_show_all ##### -->
<para>
</para>
-@src_widget:
-@dest_widget:
-@src_x:
-@src_y:
-@dest_x:
-@dest_y:
-@Returns:
+@widget:
+@no_show_all:
-<!-- ##### FUNCTION gtk_widget_hide_on_delete ##### -->
+<!-- ##### FUNCTION gtk_widget_get_no_show_all ##### -->
<para>
</para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_set_style ##### -->
+<!-- ##### FUNCTION gtk_requisition_copy ##### -->
<para>
</para>
-@widget:
-@style:
+@requisition:
+@Returns:
-<!-- ##### MACRO gtk_widget_set_rc_style ##### -->
+<!-- ##### FUNCTION gtk_requisition_free ##### -->
<para>
-Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
+
</para>
-@widget: a #GtkWidget.
+@requisition:
-<!-- ##### FUNCTION gtk_widget_ensure_style ##### -->
+<!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
<para>
</para>
-@widget:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_get_style ##### -->
+<!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### MACRO gtk_widget_restore_default_style ##### -->
+<!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
<para>
-Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
-</para>
-
-@widget: a #GtkWidget.
-
-<!-- ##### FUNCTION gtk_widget_reset_rc_styles ##### -->
-<para>
-Reset the styles of @widget and all descendents, so when
-they are looked up again, they get the correct values
-for the currently loaded RC file settings.
-</para>
-<para>
-This function is not useful for applications.
</para>
-@widget: a #GtkWidget.
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_push_colormap ##### -->
+<!-- ##### SIGNAL GtkWidget::child-notify ##### -->
<para>
</para>
-@cmap:
-
+@widget: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_widget_pop_colormap ##### -->
+<!-- ##### SIGNAL GtkWidget::client-event ##### -->
<para>
</para>
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-
-<!-- ##### FUNCTION gtk_widget_set_default_colormap ##### -->
+<!-- ##### SIGNAL GtkWidget::configure-event ##### -->
<para>
</para>
-@colormap:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_default_style ##### -->
+<!-- ##### SIGNAL GtkWidget::delete-event ##### -->
<para>
</para>
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_default_colormap ##### -->
+<!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
<para>
</para>
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_default_visual ##### -->
+<!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
<para>
</para>
-@Returns:
-
+@widget: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_widget_set_direction ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-begin ##### -->
<para>
</para>
-@widget:
-@dir:
-
+@widget: the object which received the signal.
+@drag_context:
-<!-- ##### ENUM GtkTextDirection ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-data-delete ##### -->
<para>
</para>
-@GTK_TEXT_DIR_NONE:
-@GTK_TEXT_DIR_LTR:
-@GTK_TEXT_DIR_RTL:
+@widget: the object which received the signal.
+@drag_context:
-<!-- ##### FUNCTION gtk_widget_get_direction ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-data-get ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@drag_context:
+@data:
+@info:
+@time:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_set_default_direction ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-data-received ##### -->
<para>
</para>
-@dir:
-
+@widget: the object which received the signal.
+@drag_context:
+@x:
+@y:
+@data:
+@info:
+@time:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_get_default_direction ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-drop ##### -->
<para>
</para>
+@widget: the object which received the signal.
+@drag_context:
+@x:
+@y:
+@time:
@Returns:
+<!-- # Unused Parameters # -->
+@time_:
-
-<!-- ##### FUNCTION gtk_widget_shape_combine_mask ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-end ##### -->
<para>
</para>
-@widget:
-@shape_mask:
-@offset_x:
-@offset_y:
-
+@widget: the object which received the signal.
+@drag_context:
-<!-- ##### FUNCTION gtk_widget_path ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-leave ##### -->
<para>
</para>
-@widget:
-@path_length:
-@path:
-@path_reversed:
-
+@widget: the object which received the signal.
+@drag_context:
+@time:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_class_path ##### -->
+<!-- ##### SIGNAL GtkWidget::drag-motion ##### -->
<para>
</para>
-@widget:
-@path_length:
-@path:
-@path_reversed:
-
+@widget: the object which received the signal.
+@drag_context:
+@x:
+@y:
+@time:
+@Returns:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_get_composite_name ##### -->
+<!-- ##### SIGNAL GtkWidget::enter-notify-event ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_modify_style ##### -->
+<!-- ##### SIGNAL GtkWidget::event ##### -->
<para>
</para>
-@widget:
-@style:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_modifier_style ##### -->
+<!-- ##### SIGNAL GtkWidget::event-after ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
-<!-- ##### FUNCTION gtk_widget_modify_fg ##### -->
+<!-- ##### SIGNAL GtkWidget::expose-event ##### -->
<para>
</para>
-@widget:
-@state:
-@color:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_modify_bg ##### -->
+<!-- ##### SIGNAL GtkWidget::focus ##### -->
<para>
</para>
-@widget:
-@state:
-@color:
-
+@widget: the object which received the signal.
+@arg1:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_modify_text ##### -->
+<!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
<para>
</para>
-@widget:
-@state:
-@color:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_modify_base ##### -->
+<!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
<para>
</para>
-@widget:
-@state:
-@color:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_modify_font ##### -->
+<!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
<para>
</para>
-@widget:
-@font_desc:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_create_pango_context ##### -->
+<!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_widget_get_pango_context ##### -->
+<!-- ##### SIGNAL GtkWidget::hide ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_create_pango_layout ##### -->
+<!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
<para>
-
+Emitted when there is a chance in the hierarchy to
+which a widget belong. More precisely, a widget is
+<firstterm>anchored</firstterm> when its toplevel
+ancestor is a #GtkWindow. This signal is emitted when
+a widget changes from un-anchored to anchored or vice-versa.
</para>
-@widget:
-@text:
-@Returns:
-
+@widget: the object which received the signal.
+@widget2:
-<!-- ##### FUNCTION gtk_widget_render_icon ##### -->
+<!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
<para>
</para>
-@widget:
-@stock_id:
-@size:
-@detail:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_pop_composite_child ##### -->
+<!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
<para>
</para>
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-
-<!-- ##### FUNCTION gtk_widget_push_composite_child ##### -->
+<!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
<para>
</para>
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-
-<!-- ##### FUNCTION gtk_widget_queue_clear ##### -->
+<!-- ##### SIGNAL GtkWidget::map ##### -->
<para>
</para>
-@widget:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_queue_clear_area ##### -->
+<!-- ##### SIGNAL GtkWidget::map-event ##### -->
<para>
</para>
-@widget:
-@x:
-@y:
-@width:
-@height:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_queue_draw_area ##### -->
+<!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
<para>
</para>
-@widget:
-@x:
-@y:
-@width:
-@height:
-
+@widget: the object which received the signal.
+@arg1:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_reset_shapes ##### -->
+<!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
<para>
</para>
-@widget:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_set_app_paintable ##### -->
+<!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
<para>
</para>
-@widget:
-@app_paintable:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_set_double_buffered ##### -->
+<!-- ##### SIGNAL GtkWidget::parent-set ##### -->
<para>
</para>
-@widget:
-@double_buffered:
-
+@widget: the object which received the signal.
+@old_parent:
-<!-- ##### FUNCTION gtk_widget_set_redraw_on_allocate ##### -->
+<!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
<para>
</para>
-@widget:
-@redraw_on_allocate:
-
+@widget: the object which received the signal.
+@Returns:
-<!-- ##### FUNCTION gtk_widget_set_composite_name ##### -->
+<!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
<para>
</para>
-@widget:
-@name:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_set_scroll_adjustments ##### -->
+<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
<para>
</para>
-@widget:
-@hadjustment:
-@vadjustment:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
+<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
<para>
</para>
-@widget:
-@group_cycling:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_class_install_style_property ##### -->
+<!-- ##### SIGNAL GtkWidget::realize ##### -->
<para>
</para>
-@klass:
-@pspec:
-<!-- # Unused Parameters # -->
-@class:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_class_install_style_property_parser ##### -->
+<!-- ##### SIGNAL GtkWidget::screen-changed ##### -->
<para>
</para>
-@klass:
-@pspec:
-@parser:
-<!-- # Unused Parameters # -->
-@class:
-
+@widget: the object which received the signal.
+@arg1:
-<!-- ##### FUNCTION gtk_widget_class_find_style_property ##### -->
+<!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
<para>
</para>
-@klass:
-@property_name:
-@Returns:
-<!-- # Unused Parameters # -->
-@class:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_class_list_style_properties ##### -->
+<!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
<para>
</para>
-@klass:
-@n_properties:
-@Returns:
-<!-- # Unused Parameters # -->
-@class:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_region_intersect ##### -->
+<!-- ##### SIGNAL GtkWidget::selection-get ##### -->
<para>
</para>
-@widget:
-@region:
-@Returns:
-
+@widget: the object which received the signal.
+@data:
+@info:
+@time:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_send_expose ##### -->
+<!-- ##### SIGNAL GtkWidget::selection-notify-event ##### -->
<para>
</para>
-@widget:
+@widget: the object which received the signal.
@event:
-@Returns:
-
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_style_get ##### -->
+<!-- ##### SIGNAL GtkWidget::selection-received ##### -->
<para>
</para>
-@widget:
-@first_property_name:
-@Varargs:
-
+@widget: the object which received the signal.
+@data:
+@time:
+<!-- # Unused Parameters # -->
+@time_:
-<!-- ##### FUNCTION gtk_widget_style_get_property ##### -->
+<!-- ##### SIGNAL GtkWidget::selection-request-event ##### -->
<para>
</para>
-@widget:
-@property_name:
-@value:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_style_get_valist ##### -->
+<!-- ##### SIGNAL GtkWidget::show ##### -->
<para>
</para>
-@widget:
-@first_property_name:
-@var_args:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_get_accessible ##### -->
+<!-- ##### SIGNAL GtkWidget::show-help ##### -->
<para>
</para>
-@widget:
+@widget: the object which received the signal.
+@arg1:
@Returns:
-
-<!-- ##### FUNCTION gtk_widget_child_focus ##### -->
+<!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
<para>
</para>
-@widget:
-@direction:
-@Returns:
-
+@widget: the object which received the signal.
+@allocation:
-<!-- ##### FUNCTION gtk_widget_child_notify ##### -->
+<!-- ##### SIGNAL GtkWidget::size-request ##### -->
<para>
</para>
-@widget:
-@child_property:
-
+@widget: the object which received the signal.
+@requisition:
-<!-- ##### FUNCTION gtk_widget_freeze_child_notify ##### -->
+<!-- ##### SIGNAL GtkWidget::state-changed ##### -->
<para>
</para>
-@widget:
-
+@widget: the object which received the signal.
+@state:
-<!-- ##### FUNCTION gtk_widget_get_child_visible ##### -->
+<!-- ##### SIGNAL GtkWidget::style-set ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@previous_style:
-<!-- ##### FUNCTION gtk_widget_get_parent ##### -->
+<!-- ##### SIGNAL GtkWidget::unmap ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_get_settings ##### -->
+<!-- ##### SIGNAL GtkWidget::unmap-event ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_clipboard ##### -->
+<!-- ##### SIGNAL GtkWidget::unrealize ##### -->
<para>
</para>
-@widget:
-@selection:
-@Returns:
-
+@widget: the object which received the signal.
-<!-- ##### FUNCTION gtk_widget_get_display ##### -->
+<!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_root_window ##### -->
+<!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
<para>
</para>
-@widget:
-@Returns:
-
+@widget: the object which received the signal.
+@event:
+@Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
-<!-- ##### FUNCTION gtk_widget_get_screen ##### -->
+<!-- ##### ARG GtkWidget:app-paintable ##### -->
<para>
</para>
-@widget:
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_widget_has_screen ##### -->
+<!-- ##### ARG GtkWidget:can-default ##### -->
<para>
</para>
-@widget:
-@Returns:
-
-
-<!-- ##### FUNCTION gtk_widget_get_size_request ##### -->
+<!-- ##### ARG GtkWidget:can-focus ##### -->
<para>
</para>
-@widget:
-@width:
-@height:
-
-
-<!-- ##### MACRO gtk_widget_pop_visual ##### -->
+<!-- ##### ARG GtkWidget:composite-child ##### -->
<para>
-This function is deprecated; it does nothing.
+
</para>
+<!-- ##### ARG GtkWidget:events ##### -->
+<para>
+</para>
-<!-- ##### MACRO gtk_widget_push_visual ##### -->
+<!-- ##### ARG GtkWidget:extension-events ##### -->
<para>
-This function is deprecated; it does nothing.
+
</para>
-@visual:
+<!-- ##### ARG GtkWidget:has-default ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_widget_set_child_visible ##### -->
+<!-- ##### ARG GtkWidget:has-focus ##### -->
<para>
</para>
-@widget:
-@is_visible:
+<!-- ##### ARG GtkWidget:height-request ##### -->
+<para>
+</para>
-<!-- ##### MACRO gtk_widget_set_default_visual ##### -->
+<!-- ##### ARG GtkWidget:is-focus ##### -->
<para>
-This function is deprecated; it does nothing.
+
</para>
-@visual:
+<!-- ##### ARG GtkWidget:name ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_widget_set_size_request ##### -->
+<!-- ##### ARG GtkWidget:no-show-all ##### -->
<para>
</para>
-@widget:
-@width:
-@height:
+<!-- ##### ARG GtkWidget:parent ##### -->
+<para>
+</para>
-<!-- ##### MACRO gtk_widget_set_visual ##### -->
+<!-- ##### ARG GtkWidget:receives-default ##### -->
<para>
-This function is deprecated; it does nothing.
+
</para>
-@widget:
-@visual:
+<!-- ##### ARG GtkWidget:sensitive ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_widget_thaw_child_notify ##### -->
+<!-- ##### ARG GtkWidget:style ##### -->
<para>
</para>
-@widget:
+<!-- ##### ARG GtkWidget:visible ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_widget_set_no_show_all ##### -->
+<!-- ##### ARG GtkWidget:width-request ##### -->
<para>
</para>
-@widget:
-@no_show_all:
+<!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_widget_get_no_show_all ##### -->
+<!-- ##### ARG GtkWidget:cursor-color ##### -->
<para>
</para>
-@widget:
-@Returns:
+<!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_requisition_copy ##### -->
+<!-- ##### ARG GtkWidget:focus-line-width ##### -->
<para>
</para>
-@requisition:
-@Returns:
+<!-- ##### ARG GtkWidget:focus-padding ##### -->
+<para>
+</para>
-<!-- ##### FUNCTION gtk_requisition_free ##### -->
+<!-- ##### ARG GtkWidget:interior-focus ##### -->
<para>
</para>
-@requisition:
+<!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->
+<para>
+</para>
</para>
-<!-- ##### SIGNAL GtkWindow::activate-default ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-
-<!-- ##### SIGNAL GtkWindow::activate-focus ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-
-<!-- ##### SIGNAL GtkWindow::frame-event ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-@event:
-@Returns:
-
-<!-- ##### SIGNAL GtkWindow::keys-changed ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-
-<!-- ##### SIGNAL GtkWindow::move-focus ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-@arg1:
-
-<!-- ##### SIGNAL GtkWindow::set-focus ##### -->
-<para>
-
-</para>
-
-@window: the object which received the signal.
-@widget:
-
-<!-- ##### ARG GtkWindow:allow-grow ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:allow-shrink ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:decorated ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:default-height ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:default-width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:destroy-with-parent ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:gravity ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:has-toplevel-focus ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:icon ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:is-active ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:modal ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:resizable ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:role ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:screen ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:skip-pager-hint ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:skip-taskbar-hint ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:title ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:type ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:type-hint ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWindow:window-position ##### -->
-<para>
-
-</para>
-
<!-- ##### FUNCTION gtk_window_new ##### -->
<para>
@height:
+<!-- ##### SIGNAL GtkWindow::activate-default ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+
+<!-- ##### SIGNAL GtkWindow::activate-focus ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+
+<!-- ##### SIGNAL GtkWindow::frame-event ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+@event:
+@Returns:
+
+<!-- ##### SIGNAL GtkWindow::keys-changed ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+
+<!-- ##### SIGNAL GtkWindow::move-focus ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GtkWindow::set-focus ##### -->
+<para>
+
+</para>
+
+@window: the object which received the signal.
+@widget:
+
+<!-- ##### ARG GtkWindow:allow-grow ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:allow-shrink ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:decorated ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:default-height ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:default-width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:destroy-with-parent ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:gravity ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:has-toplevel-focus ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:icon ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:is-active ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:modal ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:resizable ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:role ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:screen ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:skip-pager-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:skip-taskbar-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:type-hint ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkWindow:window-position ##### -->
+<para>
+
+</para>
+
#define MENU_ID "gtk-separator-tool-item-menu-id"
-static void gtk_separator_tool_item_class_init (GtkSeparatorToolItemClass *class);
-static gboolean gtk_separator_tool_item_create_menu_proxy (GtkToolItem *item);
-static void gtk_separator_tool_item_size_request (GtkWidget *widget,
-
- GtkRequisition *requisition);
-static gboolean gtk_separator_tool_item_expose (GtkWidget *widget,
- GdkEventExpose *event);
-static void gtk_separator_tool_item_add (GtkContainer *container,
- GtkWidget *child);
-static GtkToolbarSpaceStyle get_space_style (GtkToolItem *tool_item);
-static gint get_space_size (GtkToolItem *tool_item);
+enum {
+ PROP_0,
+ PROP_DRAW
+};
+
+static void gtk_separator_tool_item_class_init (GtkSeparatorToolItemClass *class);
+static void gtk_separator_tool_item_init (GtkSeparatorToolItem *separator_item,
+ GtkSeparatorToolItemClass *class);
+static gboolean gtk_separator_tool_item_create_menu_proxy (GtkToolItem *item);
+static void gtk_separator_tool_item_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec);
+static void gtk_separator_tool_item_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec);
+static void gtk_separator_tool_item_size_request (GtkWidget *widget,
+ GtkRequisition *requisition);
+static gboolean gtk_separator_tool_item_expose (GtkWidget *widget,
+ GdkEventExpose *event);
+static void gtk_separator_tool_item_add (GtkContainer *container,
+ GtkWidget *child);
+static GtkToolbarSpaceStyle get_space_style (GtkToolItem *tool_item);
+static gint get_space_size (GtkToolItem *tool_item);
+
+
static GObjectClass *parent_class = NULL;
+#define GTK_SEPARATOR_TOOL_ITEM_GET_PRIVATE(obj)(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_SEPARATOR_TOOL_ITEM, GtkSeparatorToolItemPrivate))
+
+struct _GtkSeparatorToolItemPrivate
+{
+ guint draw : 1;
+};
GType
gtk_separator_tool_item_get_type (void)
{
static GType type = 0;
-
+
if (!type)
{
static const GTypeInfo type_info =
NULL,
sizeof (GtkSeparatorToolItem),
0, /* n_preallocs */
- (GInstanceInitFunc) NULL,
+ (GInstanceInitFunc) gtk_separator_tool_item_init,
};
-
+
type = g_type_register_static (GTK_TYPE_TOOL_ITEM,
"GtkSeparatorToolItem", &type_info, 0);
}
{
GtkToolbarSpaceStyle space_style = DEFAULT_SPACE_STYLE;
GtkWidget *parent = GTK_WIDGET (tool_item)->parent;
-
+
if (GTK_IS_TOOLBAR (parent))
{
gtk_widget_style_get (parent,
"space_style", &space_style,
NULL);
}
-
+
return space_style;
}
"space_size", &space_size,
NULL);
}
-
+
return space_size;
}
static void
gtk_separator_tool_item_class_init (GtkSeparatorToolItemClass *class)
{
+ GObjectClass *object_class;
GtkContainerClass *container_class;
GtkToolItemClass *toolitem_class;
GtkWidgetClass *widget_class;
-
+
parent_class = g_type_class_peek_parent (class);
+ object_class = (GObjectClass *)class;
container_class = (GtkContainerClass *)class;
toolitem_class = (GtkToolItemClass *)class;
widget_class = (GtkWidgetClass *)class;
+ object_class->set_property = gtk_separator_tool_item_set_property;
+ object_class->get_property = gtk_separator_tool_item_get_property;
widget_class->size_request = gtk_separator_tool_item_size_request;
widget_class->expose_event = gtk_separator_tool_item_expose;
toolitem_class->create_menu_proxy = gtk_separator_tool_item_create_menu_proxy;
-
+
container_class->add = gtk_separator_tool_item_add;
+
+ g_object_class_install_property (object_class,
+ PROP_DRAW,
+ g_param_spec_boolean ("draw",
+ _("Draw"),
+ _("Whether the separator is drawn, or just blank"),
+ TRUE,
+ G_PARAM_READWRITE));
+
+ g_type_class_add_private (object_class, sizeof (GtkSeparatorToolItemPrivate));
+}
+
+static void
+gtk_separator_tool_item_init (GtkSeparatorToolItem *separator_item,
+ GtkSeparatorToolItemClass *class)
+{
+ separator_item->priv = GTK_SEPARATOR_TOOL_ITEM_GET_PRIVATE (separator_item);
+ separator_item->priv->draw = TRUE;
}
static void
return TRUE;
}
+static void
+gtk_separator_tool_item_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ GtkSeparatorToolItem *item = GTK_SEPARATOR_TOOL_ITEM (object);
+
+ switch (prop_id)
+ {
+ case PROP_DRAW:
+ gtk_separator_tool_item_set_draw (item, g_value_get_boolean (value));
+ break;
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
+static void
+gtk_separator_tool_item_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ GtkSeparatorToolItem *item = GTK_SEPARATOR_TOOL_ITEM (object);
+
+ switch (prop_id)
+ {
+ case PROP_DRAW:
+ g_value_set_boolean (value, gtk_separator_tool_item_get_draw (item));
+ break;
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
static void
gtk_separator_tool_item_size_request (GtkWidget *widget,
GtkRequisition *requisition)
{
GtkToolItem *item = GTK_TOOL_ITEM (widget);
GtkOrientation orientation = gtk_tool_item_get_orientation (item);
-
+
if (orientation == GTK_ORIENTATION_HORIZONTAL)
{
requisition->width = get_space_size (item);
GdkEventExpose *event)
{
GtkToolItem *tool_item = GTK_TOOL_ITEM (widget);
+ GtkSeparatorToolItem *separator_tool_item = GTK_SEPARATOR_TOOL_ITEM (widget);
gint space_size;
GtkAllocation *allocation;
GtkOrientation orientation;
GdkRectangle *area;
- if (get_space_style (tool_item) == GTK_TOOLBAR_SPACE_LINE)
+ if (separator_tool_item->priv->draw &&
+ get_space_style (tool_item) == GTK_TOOLBAR_SPACE_LINE)
{
space_size = get_space_size (tool_item);
allocation = &(widget->allocation);
orientation = gtk_tool_item_get_orientation (tool_item);
area = &(event->area);
-
+
if (orientation == GTK_ORIENTATION_HORIZONTAL)
{
gtk_paint_vline (widget->style, widget->window,
}
}
- return TRUE;
+ return FALSE;
}
/**
gtk_separator_tool_item_new (void)
{
GtkToolItem *self;
-
+
self = g_object_new (GTK_TYPE_SEPARATOR_TOOL_ITEM,
NULL);
return self;
}
+
+/**
+ * gtk_separator_tool_item_get_draw:
+ * @separator_tool_item: a #GtkSeparatorToolItem
+ *
+ * Returns whether @separator_tool_item is drawn as a
+ * line, or just blank. See gtk_separator_tool_item_set_draw().
+ *
+ * Return value: #TRUE if @separator_tool_item is drawn as a line, or just blank.
+ *
+ * Since: 2.4
+ **/
+gboolean
+gtk_separator_tool_item_get_draw (GtkSeparatorToolItem *separator_tool_item)
+{
+ g_return_val_if_fail (GTK_IS_SEPARATOR_TOOL_ITEM (separator_tool_item), FALSE);
+
+ return separator_tool_item->priv->draw;
+}
+
+/**
+ * gtk_separator_tool_item_set_draw:
+ * @separator_tool_item: a #GtkSeparatorToolItem
+ * @draw: whether @separator_tool_item is drawn as a vertical iln
+ *
+ * When @separator_tool_items is drawn as a vertical line, or just blank.
+ * Setting this #FALSE along with gtk_tool_item_set_expand() is useful
+ * to create an item that forces following items to the end of the toolbar.
+ *
+ * Since: 2.4
+ **/
+void
+gtk_separator_tool_item_set_draw (GtkSeparatorToolItem *separator_tool_item,
+ gboolean draw)
+{
+ g_return_if_fail (GTK_IS_SEPARATOR_TOOL_ITEM (separator_tool_item));
+
+ draw = draw != FALSE;
+
+ if (draw != separator_tool_item->priv->draw)
+ {
+ separator_tool_item->priv->draw = draw;
+
+ gtk_widget_queue_draw (GTK_WIDGET (separator_tool_item));
+
+ g_object_notify (G_OBJECT (separator_tool_item), "draw");
+ }
+}
+
#define GTK_IS_SEPARATOR_TOOL_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), GTK_TYPE_SEPARATOR_TOOL_ITEM))
#define GTK_SEPARATOR_TOOL_ITEM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GTK_TYPE_SEPARATOR_TOOL_ITEM, GtkSeparatorToolItemClass))
-typedef struct _GtkSeparatorToolItem GtkSeparatorToolItem;
-typedef struct _GtkSeparatorToolItemClass GtkSeparatorToolItemClass;
+typedef struct _GtkSeparatorToolItem GtkSeparatorToolItem;
+typedef struct _GtkSeparatorToolItemClass GtkSeparatorToolItemClass;
+typedef struct _GtkSeparatorToolItemPrivate GtkSeparatorToolItemPrivate;
struct _GtkSeparatorToolItem
{
GtkToolItem parent;
+
+ /*< private >*/
+ GtkSeparatorToolItemPrivate *priv;
};
struct _GtkSeparatorToolItemClass
GType gtk_separator_tool_item_get_type (void) G_GNUC_CONST;
GtkToolItem *gtk_separator_tool_item_new (void);
+gboolean gtk_separator_tool_item_get_draw (GtkSeparatorToolItem *item);
+void gtk_separator_tool_item_set_draw (GtkSeparatorToolItem *tool_item,
+ gboolean draw);
+
G_END_DECLS
#endif /* __GTK_SEPARATOR_TOOL_ITEM_H__ */
enum {
CHILD_PROP_0,
CHILD_PROP_EXPAND,
- CHILD_PROP_HOMOGENEOUS,
- CHILD_PROP_PACK_END,
+ CHILD_PROP_HOMOGENEOUS
};
enum {
gboolean leaving_dnd;
gboolean in_dnd;
gint n_overflow_items_when_dnd_started;
+ GtkToolItem *highlight_tool_item;
};
static GtkContainerClass *parent_class = NULL;
TRUE,
G_PARAM_READWRITE));
- gtk_container_class_install_child_property (container_class,
- CHILD_PROP_PACK_END,
- g_param_spec_uint ("pack_end",
- _("Pack End"),
- _("Whether the item is positioned at the end of the toolbar"),
- 0, G_MAXINT, 0,
- G_PARAM_READWRITE));
-
/* style properties */
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("space_size",
gint max_homogeneous_child_height;
gint homogeneous_size;
gint long_req;
- gint pack_end_size;
gint pack_front_size;
gint ipadding;
GtkRequisition arrow_requisition;
else
homogeneous_size = max_homogeneous_child_height;
- pack_end_size = 0;
pack_front_size = 0;
for (list = priv->content; list != NULL; list = list->next)
{
size = requisition.height;
}
- if (gtk_tool_item_get_pack_end (item))
- pack_end_size += size;
- else
- pack_front_size += size;
+ pack_front_size += size;
}
if (priv->show_arrow && priv->api_mode == NEW_API)
/* There is no point requesting space for the arrow if that would take
* up more space than all the items combined
*/
- long_req = MIN (long_req, pack_front_size + pack_end_size);
+ long_req = MIN (long_req, pack_front_size);
}
else
{
arrow_requisition.height = 0;
arrow_requisition.width = 0;
- long_req = pack_end_size + pack_front_size;
+ long_req = pack_front_size;
}
if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
gint available_size;
gint n_items;
gint needed_size;
- GList *content;
GtkRequisition arrow_requisition;
gint n_overflowed;
+ gboolean overflowing;
widget->allocation = *allocation;
else
size = available_size;
- content = g_list_copy (priv->content);
-
n_overflowed = 0;
-
- /* calculate widths of pack end items */
- for (list = g_list_last (content), i = 0; list != NULL; list = list->prev, ++i)
- {
- ToolbarContent *content = list->data;
- GtkToolItem *item = content->item;
- GtkAllocation *allocation = &(allocations[n_items - i - 1]);
- gint item_size;
-
- if (!gtk_tool_item_get_pack_end (item) ||
- !toolbar_item_visible (toolbar, item))
- continue;
-
- item_size = get_item_size (toolbar, GTK_WIDGET (item));
- if (item_size <= size)
- {
- size -= item_size;
- allocation->width = item_size;
- content->is_overflow = FALSE;
- }
- else
- {
- while (list)
- {
- content = list->data;
- item = content->item;
- if (gtk_tool_item_get_pack_end (item))
- content->is_overflow = TRUE;
- ++n_overflowed;
- list = list->prev;
- }
- break;
- }
- }
/* calculate widths of pack front items */
- for (list = content, i = 0; list != NULL; list = list->next, ++i)
+ overflowing = FALSE;
+ for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
{
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
gint item_size;
- if (gtk_tool_item_get_pack_end (item) || !toolbar_item_visible (toolbar, item))
+ if (!toolbar_item_visible (toolbar, item))
continue;
item_size = get_item_size (toolbar, GTK_WIDGET (item));
- if (item_size <= size)
+ if (item_size <= size && !overflowing)
{
size -= item_size;
allocations[i].width = item_size;
}
else
{
- while (list)
- {
- content = list->data;
- item = content->item;
- if (!gtk_tool_item_get_pack_end (item))
- content->is_overflow = TRUE;
- ++n_overflowed;
- list = list->next;
- }
- break;
+ ++n_overflowed;
+ content->is_overflow = TRUE;
+ overflowing = TRUE;
}
}
if (toolbar_item_visible (toolbar, item) &&
gtk_tool_item_get_expand (item) &&
- !content->is_overflow &&
- !GTK_IS_SEPARATOR_TOOL_ITEM (item))
+ !content->is_overflow)
{
n_expand_items++;
}
}
- for (list = content, i = 0; list != NULL; list = list->next, ++i)
+ for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
{
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
- if (toolbar_item_visible (toolbar, item) && gtk_tool_item_get_expand (item) &&
- !content->is_overflow &&
- !GTK_IS_SEPARATOR_TOOL_ITEM (item))
+ if (toolbar_item_visible (toolbar, item) &&
+ gtk_tool_item_get_expand (item) &&
+ !content->is_overflow)
{
gint extra = size / n_expand_items;
if (size % n_expand_items != 0)
g_assert (n_expand_items == 0);
}
- /* position pack front items */
+ /* position regular items */
pos = border_width;
- for (list = content, i = 0; list != NULL; list = list->next, ++i)
+ for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
{
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
- if (toolbar_item_visible (toolbar, item) &&
- !content->is_overflow &&
- !gtk_tool_item_get_pack_end (item))
+ if (toolbar_item_visible (toolbar, item) && !content->is_overflow)
{
allocations[i].x = pos;
allocations[i].y = border_width;
}
}
- /* position pack end items */
- pos = available_size + border_width;
- for (list = g_list_last (content), i = 0; list != NULL; list = list->prev, ++i)
- {
- ToolbarContent *content = list->data;
- GtkToolItem *item = content->item;
-
- if (toolbar_item_visible (toolbar, item) &&
- !content->is_overflow &&
- gtk_tool_item_get_pack_end (item))
- {
- GtkAllocation *allocation = &(allocations[n_items - i - 1]);
-
- allocation->x = pos - allocation->width;
- allocation->y = border_width;
- allocation->height = short_size;
-
- pos -= allocation->width;
- }
- }
-
/* position arrow */
if (need_arrow)
{
- arrow_allocation.x = pos - arrow_allocation.width;
+ arrow_allocation.x = available_size - border_width - arrow_allocation.width;
arrow_allocation.y = border_width;
}
}
/* finally allocate the items */
- for (list = content, i = 0; list != NULL; list = list->next, i++)
+ for (list = priv->content, i = 0; list != NULL; list = list->next, i++)
{
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
}
g_free (allocations);
- g_list_free (content);
}
static void
{
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
- if (!gtk_tool_item_get_pack_end (item))
- result = g_list_prepend (result, item);
+
+ result = g_list_prepend (result, item);
}
result = g_list_prepend (result, priv->arrow_button);
- for (list = priv->content; list != NULL; list = list->next)
- {
- ToolbarContent *content = list->data;
- GtkToolItem *item = content->item;
-
- if (gtk_tool_item_get_pack_end (item))
- result = g_list_prepend (result, item);
- }
-
rtl = (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL);
/* move in logical order when
ToolbarContent *content = list->data;
GtkToolItem *item = content->item;
- if (!gtk_tool_item_get_pack_end (item) &&
- toolbar_item_visible (toolbar, item) &&
- !content->is_overflow)
- {
- interesting_content = g_list_prepend (interesting_content, content);
- }
+ if (toolbar_item_visible (toolbar, item) && !content->is_overflow)
+ interesting_content = g_list_prepend (interesting_content, content);
}
interesting_content = g_list_reverse (interesting_content);
gtk_widget_queue_resize_no_redraw (GTK_WIDGET (toolbar));
- GDK_THREADS_LEAVE();
-
if (!cont)
{
priv->idle_id = 0;
priv->n_overflow_items_when_dnd_started = 0;
}
+ GDK_THREADS_LEAVE();
+
return FALSE;
}
+ GDK_THREADS_LEAVE();
+
return TRUE;
}
g_timer_reset (priv->timer);
}
+static gint
+physical_to_logical (GtkToolbar *toolbar, gint physical)
+{
+ GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
+ GList *list;
+ int logical;
+
+ g_assert (physical >= 0);
+
+ logical = 0;
+ for (list = priv->content; list && physical > 0; list = list->next)
+ {
+ ToolbarContent *content = list->data;
+
+ if (!content->is_placeholder)
+ logical++;
+ physical--;
+ }
+
+ g_assert (physical == 0);
+
+ return logical;
+}
+
+static gint
+logical_to_physical (GtkToolbar *toolbar, gint logical)
+{
+ GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
+ GList *list;
+ gint physical;
+
+ g_assert (logical >= 0);
+
+ physical = 0;
+ for (list = priv->content; list && logical > 0; list = list->next)
+ {
+ ToolbarContent *content = list->data;
+
+ if (!content->is_placeholder)
+ logical--;
+ physical++;
+ }
+
+ g_assert (logical == 0);
+ return physical;
+}
+
+static void
+get_item_requisition (GtkToolbar *toolbar,
+ GtkToolItem *tool_item,
+ gint *width,
+ gint *height)
+{
+ GtkRequisition requisition;
+
+ g_object_ref (G_OBJECT (tool_item));
+ gtk_widget_set_parent (GTK_WIDGET (tool_item), GTK_WIDGET (toolbar));
+
+ gtk_widget_size_request (GTK_WIDGET (tool_item), &requisition);
+ *width = requisition.width;
+ *height = requisition.height;
+
+ gtk_widget_unparent (GTK_WIDGET (tool_item));
+ g_object_unref (G_OBJECT (tool_item));
+}
+
+/**
+ * gtk_toolbar_highlight_drop_location:
+ * @toolbar: a #GtkToolbar
+ * @index: the toolbar position to highlight, or -1
+ * @tool_item: a #GtkToolbar that isn't part of a widget hierarchy
+ *
+ * Highlights the position on the toolbar indicated by @index to give
+ * an idea of how @toolbar would look if @tool_item was added to it at
+ * @index.
+ *
+ * After calling this function gtk_toolbar_unhighlight_drop_location() must
+ * be called before @tool_item can be added to any widget hierarchy.
+ *
+ * Since: 2.4
+ **/
void
-gtk_toolbar_highlight_drop_location (GtkToolbar *toolbar,
- gint x,
- gint y,
- gint width,
- gint height)
+gtk_toolbar_highlight_drop_location (GtkToolbar *toolbar,
+ gint index,
+ GtkToolItem *tool_item)
{
- gint index;
ToolbarContent *content;
- GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
+ GtkToolbarPrivate *priv;
gint start_width, start_height;
GList *list;
+ gint n_items;
+ GtkRequisition requisition;
+
+ g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
+ g_return_if_fail (GTK_IS_TOOL_ITEM (tool_item));
+
+ priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
+
+ if (tool_item != priv->highlight_tool_item)
+ {
+ if (priv->highlight_tool_item)
+ g_object_unref (priv->highlight_tool_item);
+
+ gtk_object_sink (GTK_OBJECT (g_object_ref (tool_item)));
+ priv->highlight_tool_item = tool_item;
+
+ gtk_widget_set_parent (GTK_WIDGET (priv->highlight_tool_item),
+ GTK_WIDGET (toolbar));
+ }
+
if (!priv->in_dnd)
{
priv->n_overflow_items_when_dnd_started = 0;
priv->in_dnd = TRUE;
priv->leaving_dnd = FALSE;
-
- index = find_drop_index (toolbar, x, y);
+ n_items = gtk_toolbar_get_n_items (toolbar);
+ if (index < 0 || index > n_items)
+ index = n_items;
+
+ index = logical_to_physical (toolbar, index);
+
content = g_list_nth_data (priv->content, index);
if (index > 0)
g_assert (content);
g_assert (content->is_placeholder);
+ gtk_widget_size_request (GTK_WIDGET (priv->highlight_tool_item),
+ &requisition);
+
if (content->start_width != start_width ||
content->start_height != start_height ||
- content->goal_width != width ||
- content->goal_height != height)
+ content->goal_width != requisition.width ||
+ content->goal_height != requisition.height)
{
reset_all_placeholders (toolbar);
content->start_width = start_width;
- content->goal_width = width;
+ content->goal_width = requisition.width;
content->start_height = start_height;
- content->goal_height = height;
+ content->goal_height = requisition.height;
ensure_idle_handler (toolbar);
}
priv->leaving_dnd = TRUE;
reset_all_placeholders (toolbar);
ensure_idle_handler (toolbar);
+
+ if (priv->highlight_tool_item)
+ {
+ gtk_widget_unparent (GTK_WIDGET (priv->highlight_tool_item));
+ g_object_unref (priv->highlight_tool_item);
+ priv->highlight_tool_item = NULL;
+ }
}
static void
switch (property_id)
{
- case CHILD_PROP_PACK_END:
- g_value_set_boolean (value, gtk_tool_item_get_pack_end (item));
- break;
-
case CHILD_PROP_HOMOGENEOUS:
g_value_set_boolean (value, gtk_tool_item_get_homogeneous (item));
break;
{
switch (property_id)
{
- case CHILD_PROP_PACK_END:
- gtk_tool_item_set_pack_end (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
- break;
-
case CHILD_PROP_HOMOGENEOUS:
gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
break;
case CHILD_PROP_EXPAND:
gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
break;
-
+
default:
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
break;
return TRUE;
}
-static gint
-physical_to_logical (GtkToolbar *toolbar, gint physical)
-{
- GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
- GList *list;
- int logical;
-
- if (physical < 0)
- return -1;
-
- logical = 0;
- for (list = priv->content; list; list = list->next)
- {
- ToolbarContent *content = list->data;
-
- if (!physical)
- return logical;
-
- if (!content->is_placeholder)
- logical++;
- physical--;
- }
- return -1;
-}
-
-static gint
-logical_to_physical (GtkToolbar *toolbar, gint logical)
-{
- GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
- GList *list;
- gint physical;
-
- if (logical < 0)
- return -1;
-
- physical = 0;
- for (list = priv->content; list; list = list->next)
- {
- ToolbarContent *content = list->data;
-
- if (!logical)
- return physical;
-
- if (!content->is_placeholder)
- logical--;
- physical++;
- }
- return -1;
-}
-
static void
gtk_toolbar_insert_tool_item (GtkToolbar *toolbar,
GtkToolItem *item,
if (!gtk_toolbar_check_new_api (toolbar))
return;
- gtk_toolbar_insert_tool_item (toolbar, item,
- logical_to_physical (toolbar, pos), FALSE);
+ if (pos >= 0)
+ pos = logical_to_physical (toolbar, pos);
+
+ gtk_toolbar_insert_tool_item (toolbar, item, pos, FALSE);
}
/**
priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
- if (!priv->content)
- return 0;
-
- return physical_to_logical (toolbar, g_list_length (priv->content) - 1);
+ return physical_to_logical (toolbar, g_list_length (priv->content));
}
/**
gint y)
{
g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
-
+
if (!gtk_toolbar_check_new_api (toolbar))
return -1;
-
+
return physical_to_logical (toolbar, find_drop_index (toolbar, x, y));
}
#include <gtk/gtkpixmap.h>
#include <gtk/gtksignal.h>
-#endif
+#endif /* GTK_DISABLE_DEPRECATED */
G_BEGIN_DECLS
struct _GtkToolbar
{
GtkContainer container;
-
+
+ /*< private >*/
gint num_children;
GList *children;
GtkOrientation orientation;
GtkContainerClass parent_class;
/* signals */
- void (* orientation_changed) (GtkToolbar *toolbar,
+ void (* orientation_changed) (GtkToolbar *toolbar,
GtkOrientation orientation);
- void (* style_changed) (GtkToolbar *toolbar,
+ void (* style_changed) (GtkToolbar *toolbar,
GtkToolbarStyle style);
gboolean (* popup_context_menu) (GtkToolbar *toolbar,
gint x,
gint gtk_toolbar_get_n_items (GtkToolbar *toolbar);
GtkToolItem * gtk_toolbar_get_nth_item (GtkToolbar *toolbar,
gint n);
+gboolean gtk_toolbar_get_show_arrow (GtkToolbar *toolbar);
void gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
gboolean show_arrow);
+GtkOrientation gtk_toolbar_get_orientation (GtkToolbar *toolbar);
void gtk_toolbar_set_orientation (GtkToolbar *toolbar,
GtkOrientation orientation);
+gboolean gtk_toolbar_get_tooltips (GtkToolbar *toolbar);
void gtk_toolbar_set_tooltips (GtkToolbar *toolbar,
gboolean enable);
-gboolean gtk_toolbar_get_show_arrow (GtkToolbar *toolbar);
-GtkOrientation gtk_toolbar_get_orientation (GtkToolbar *toolbar);
GtkToolbarStyle gtk_toolbar_get_style (GtkToolbar *toolbar);
-GtkIconSize gtk_toolbar_get_icon_size (GtkToolbar *toolbar);
-gboolean gtk_toolbar_get_tooltips (GtkToolbar *toolbar);
-GtkReliefStyle gtk_toolbar_get_relief_style (GtkToolbar *toolbar);
void gtk_toolbar_set_style (GtkToolbar *toolbar,
GtkToolbarStyle style);
void gtk_toolbar_unset_style (GtkToolbar *toolbar);
+GtkIconSize gtk_toolbar_get_icon_size (GtkToolbar *toolbar);
+GtkReliefStyle gtk_toolbar_get_relief_style (GtkToolbar *toolbar);
gint gtk_toolbar_get_drop_index (GtkToolbar *toolbar,
gint x,
gint y);
void gtk_toolbar_highlight_drop_location (GtkToolbar *toolbar,
- gint x,
- gint y,
- gint width,
- gint height);
+ gint index,
+ GtkToolItem *tool_item);
void gtk_toolbar_unhighlight_drop_location (GtkToolbar *toolbar);
guint visible_vertical : 1;
guint homogeneous : 1;
guint expand : 1;
- guint pack_end : 1;
guint use_drag_window : 1;
guint is_important : 1;
return tool_item->priv->expand;
}
-/**
- * gtk_tool_item_set_pack_end:
- * @tool_item: a #GtkToolItem:
- * @pack_end: whether @tool_item is allocated at the end of the toolbar.
- *
- * Sets whether @tool_item is allocated at the end of the toolbar. This is
- * useful for #GtkToolItem<!-- -->s that are used as "throbbers" in
- * web-browser-type applications.
- *
- * Since: 2.4
- **/
-void
-gtk_tool_item_set_pack_end (GtkToolItem *tool_item,
- gboolean pack_end)
-{
- g_return_if_fail (GTK_IS_TOOL_ITEM (tool_item));
-
- pack_end = pack_end != FALSE;
-
- if (tool_item->priv->pack_end != pack_end)
- {
- tool_item->priv->pack_end = pack_end;
- gtk_widget_child_notify (GTK_WIDGET (tool_item), "pack_end");
- gtk_widget_queue_resize (GTK_WIDGET (tool_item));
- }
-}
-
-/**
- * gtk_tool_item_get_pack_end:
- * @tool_item: a #GtkToolItem:
- *
- * Returns whether @tool_item is packed at the end of the toolbar.
- * See gtk_tool_item_set_pack_end().
- *
- * Return value: %TRUE if @tool_item is packed at the end of the toolbar.
- *
- * Since: 2.4
- **/
-gboolean
-gtk_tool_item_get_pack_end (GtkToolItem *tool_item)
-{
- g_return_val_if_fail (GTK_IS_TOOL_ITEM (tool_item), FALSE);
-
- return tool_item->priv->pack_end;
-}
-
/**
* gtk_tool_item_set_homogeneous:
* @tool_item: a #GtkToolItem:
gboolean expand);
gboolean gtk_tool_item_get_expand (GtkToolItem *tool_item);
-void gtk_tool_item_set_pack_end (GtkToolItem *tool_item,
- gboolean pack_end);
-gboolean gtk_tool_item_get_pack_end (GtkToolItem *tool_item);
-
void gtk_tool_item_set_tooltip (GtkToolItem *tool_item,
GtkTooltips *tooltips,
const gchar *tip_text,
projects / gtk4.git / commitdiff